browser.downloads

説明

chrome.downloads API を使用して、ダウンロードの開始、モニタリング、操作、検索をプログラムで行います。

権限

downloads

この API を使用するには、拡張機能マニフェストで "downloads" 権限を宣言する必要があります。

{
  "name": "My extension",
  ...
  "permissions": [
    "downloads"
  ],
}

例

browser.downloads API の簡単な使用例については、examples/api/downloads ディレクトリをご覧ください。その他の例とソースコードの表示方法については、サンプルをご覧ください。

型

BooleanDelta

プロパティ

  • 現在

    boolean 省略可

  • 前へ

    boolean 省略可

DangerType

列挙型

「file」
ダウンロードのファイル名が不審です。

"url"
ダウンロードの URL が悪意のあるものであることが判明している。

"content"
ダウンロードされたファイルは悪意のあるファイルであることがわかっています。

"uncommon"
ダウンロードの URL は一般的にダウンロードされている URL ではなく、危害を及ぼす可能性があります。

"host"
悪意のあるバイナリを配布していることが判明しているホストからのダウンロードであり、危険性が高い。

「unwanted」
ダウンロードが望ましくない、または安全でない可能性がある。たとえば、ブラウザやパソコンの設定が変更される可能性があります。

"safe"
ダウンロードがユーザーのパソコンに及ぼす既知の危険はありません。

"accepted"
ユーザーが危険なダウンロードを承認しました。

"allowlistedByPolicy"
企業関連の値。

"asyncScanning"

"asyncLocalPasswordScanning"

"passwordProtected"

"blockedTooLarge"

"sensitiveContentWarning"

"sensitiveContentBlock"

"deepScannedFailed"

"deepScannedSafe"

"deepScannedOpenedDangerous"

"promptForScanning"

"promptForLocalPasswordScanning"

"accountCompromise"

"blockedScanFailed"

"forceSaveToGdrive"
セキュアなエンタープライズ ブラウザの拡張機能で使用します。必要に応じて、Chrome はディスクへのダウンロードをブロックし、ファイルを Google ドライブに直接ダウンロードします。

"forceSaveToOnedrive"
Secure Enterprise Browser 拡張機能で使用します。必要に応じて、Chrome はディスクへのダウンロードをブロックし、ファイルを OneDrive に直接ダウンロードします。

DoubleDelta

プロパティ

  • 現在

    number 省略可

  • 前へ

    number 省略可

DownloadDelta

プロパティ

  • canResume

    BooleanDelta 省略可

    canResume の変更（ある場合）。

  • 危険

    StringDelta 省略可

    danger の変更（ある場合）。

  • endTime

    StringDelta 省略可

    endTime の変更（ある場合）。

  • エラー

    StringDelta 省略可

    error の変更（ある場合）。

  • 存在しています

    BooleanDelta 省略可

    exists の変更（ある場合）。

  • fileSize

    DoubleDelta 省略可

    fileSize の変更（ある場合）。

  • filename

    StringDelta 省略可

    filename の変更（ある場合）。

  • finalUrl

    StringDelta 省略可

    Chrome 54 以降 Chrome 148 以降の browser.*

    finalUrl の変更（ある場合）。

  • id

    数値

    変更された DownloadItem の id。

  • パントマイム

    StringDelta 省略可

    mime の変更（ある場合）。

  • 一時停止

    BooleanDelta 省略可

    paused の変更（ある場合）。

  • startTime

    StringDelta 省略可

    startTime の変更（ある場合）。

  • state

    StringDelta 省略可

    state の変更（ある場合）。

  • totalBytes

    DoubleDelta 省略可

    totalBytes の変更（ある場合）。

  • URL

    StringDelta 省略可

    url の変更（ある場合）。

DownloadItem

プロパティ

  • byExtensionId

    文字列 省略可

    このダウンロードが拡張機能によって開始された場合、その拡張機能の識別子。一度設定すると変更されません。

  • byExtensionName

    文字列 省略可

    このダウンロードが拡張機能によって開始された場合、その拡張機能のローカライズされた名前。拡張機能の名前が変更された場合や、ユーザーが言語 / 地域を変更した場合は、変更される可能性があります。

  • bytesReceived

    数値

    ファイルの圧縮を考慮せずに、ホストからこれまでに受信したバイト数。

  • canResume

    ブール値

    ダウンロードが進行中で一時停止されている場合、または中断されていて中断されたところから再開できる場合は true。

  • 危険

    DangerType

    このダウンロードが安全であると考えられるか、不審であることがわかっているかを示します。

  • endTime

    文字列 省略可

    ダウンロードが終了した時刻（ISO 8601 形式）。Date コンストラクタに直接渡すことができます（chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.endTime) console.log(new Date(item.endTime))})})）。

  • エラー

    InterruptReason 省略可

    ダウンロードが中断された理由。複数の種類の HTTP エラーが、SERVER_ で始まるエラーのいずれかにグループ化されることがあります。ネットワークに関連するエラーは NETWORK_ で始まり、ファイル システムへのファイルの書き込みプロセスに関連するエラーは FILE_ で始まり、ユーザーが開始した中断は USER_ で始まります。

  • estimatedEndTime

    文字列 省略可

    ダウンロードが完了する推定時刻（ISO 8601 形式）。Date コンストラクタに直接渡すことができます（chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.estimatedEndTime) console.log(new Date(item.estimatedEndTime))})})）。

  • 存在しています

    ブール値

    ダウンロードしたファイルがまだ存在するかどうか。Chrome はファイルの削除を自動的に監視しないため、この情報は最新ではない可能性があります。search() を呼び出して、ファイルの存在チェックをトリガーします。存在チェックが完了したときに、ファイルが削除されていると、onChanged イベントが発生します。search() は、存在チェックが完了するのを待たずに戻るため、search() の結果がファイル システムを正確に反映していない可能性があります。また、search() は必要に応じて何度でも呼び出すことができますが、ファイルの存在を確認する頻度は 10 秒に 1 回以下です。

  • fileSize

    数値

    解凍後のファイル全体のバイト数。不明な場合は -1。

  • filename

    文字列

    絶対ローカルパス。

  • finalUrl

    文字列

    Chrome 54 以降 Chrome 148 以降の browser.*

    すべてのリダイレクト後の、このダウンロードの絶対 URL。

  • id

    数値

    ブラウザ セッション全体で持続する識別子。

  • シークレット

    ブール値

    このダウンロードが履歴に記録されている場合は false、記録されていない場合は true。

  • パントマイム

    文字列

    ファイルの MIME タイプ。

  • 一時停止

    ブール値

    ダウンロードでホストからのデータの読み取りが停止したが、接続が開いたままになっている場合は true。

  • referrer

    文字列

    絶対 URL。

  • startTime

    文字列

    ダウンロードが開始された時刻（ISO 8601 形式）。Date コンストラクタに直接渡すことができます（chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})})）。

  • state

    州名

    ダウンロードが進行中か、中断されたか、完了したかを示します。

  • totalBytes

    数値

    ファイル圧縮を考慮しない、ファイル全体のバイト数。不明な場合は -1。

  • URL

    文字列

    このダウンロードが開始された絶対 URL（リダイレクト前）。

DownloadOptions

プロパティ

  • body

    文字列 省略可

    投稿の本文。

  • conflictAction

    FilenameConflictAction 省略可

    filename がすでに存在する場合に実行するアクション。

  • filename

    文字列 省略可

    ダウンロードしたファイルを保存する Downloads ディレクトリの相対ファイルパス。サブディレクトリが含まれる場合もあります。絶対パス、空のパス、後方参照「..」を含むパスはエラーになります。onDeterminingFilename を使用すると、ファイルの MIME タイプと仮のファイル名が決定された後に、ファイル名を提案できます。

  • headers

    HeaderNameValuePair[] 省略可

    URL で HTTP[s] プロトコルを使用している場合に、リクエストとともに送信する追加の HTTP ヘッダー。各ヘッダーは、キー name と value または binaryValue を含む辞書として表され、XMLHttpRequest で許可されているものに制限されます。

  • method

    HttpMethod 省略可

    URL で HTTP[S] プロトコルを使用する場合に使用する HTTP メソッド。

  • saveAs

    boolean 省略可

    ファイル選択ツールを使用して、filename が設定されているか、すでに存在しているかにかかわらず、ユーザーがファイル名を選択できるようにします。

  • URL

    文字列

    ダウンロードする URL。

DownloadQuery

プロパティ

  • bytesReceived

    number 省略可

    ファイルの圧縮を考慮せずに、ホストからこれまでに受信したバイト数。

  • 危険

    DangerType 省略可

    このダウンロードが安全であると考えられるか、不審であることがわかっているかを示します。

  • endTime

    文字列 省略可

    ダウンロードが終了した時刻（ISO 8601 形式）。

  • endedAfter

    文字列 省略可

    指定したミリ秒（ISO 8601 形式）以降に終了した DownloadItem に結果を制限します。

  • endedBefore

    文字列 省略可

    指定されたミリ秒（ISO 8601 形式）より前に終了した DownloadItem に結果を制限します。

  • エラー

    InterruptReason 省略可

    ダウンロードが中断された理由。

  • 存在しています

    boolean 省略可

    ダウンロードしたファイルが存在するかどうか。

  • fileSize

    number 省略可

    解凍後のファイル全体のバイト数。不明な場合は -1。

  • filename

    文字列 省略可

    絶対ローカルパス。

  • filenameRegex

    文字列 省略可

    filename が指定された正規表現に一致する DownloadItem に結果を制限します。

  • finalUrl

    文字列 省略可

    Chrome 54 以降 Chrome 148 以降の browser.*

    すべてのリダイレクト後の、このダウンロードの絶対 URL。

  • finalUrlRegex

    文字列 省略可

    Chrome 54 以降 Chrome 148 以降の browser.*

    finalUrl が指定された正規表現に一致する DownloadItem に結果を制限します。

  • id

    number 省略可

    クエリする DownloadItem の id。

  • limit

    number 省略可

    返される一致する DownloadItem の最大数。デフォルトは 1,000 です。一致するすべての DownloadItem を返すには、0 に設定します。結果をページ分割する方法については、search をご覧ください。

  • パントマイム

    文字列 省略可

    ファイルの MIME タイプ。

  • orderBy

    string[] 省略可

    検索結果を並べ替えるには、この配列の要素を DownloadItem プロパティに設定します。たとえば、orderBy=['startTime'] を設定すると、DownloadItem が開始時間の昇順で並べ替えられます。降順を指定するには、先頭にハイフンを付けます（'-startTime'）。

  • 一時停止

    boolean 省略可

    ダウンロードでホストからのデータの読み取りが停止したが、接続が開いたままになっている場合は true。

  • クエリ

    string[] 省略可

    この検索キーワードの配列は、filename、url、finalUrl に、ダッシュ「-」で始まらないすべての検索キーワードが含まれ、ダッシュで始まる検索キーワードが含まれない DownloadItem に結果を制限します。

  • startTime

    文字列 省略可

    ダウンロードが開始された時刻（ISO 8601 形式）。

  • startedAfter

    文字列 省略可

    ISO 8601 形式で指定されたミリ秒以降に開始された DownloadItem に結果を制限します。

  • startedBefore

    文字列 省略可

    ISO 8601 形式で指定されたミリ秒より前に開始された DownloadItem に結果を制限します。

  • state

    State 省略可

    ダウンロードが進行中か、中断されたか、完了したかを示します。

  • totalBytes

    number 省略可

    ファイル圧縮を考慮しない、ファイル全体のバイト数。不明な場合は -1。

  • totalBytesGreater

    number 省略可

    totalBytes が指定された整数より大きい DownloadItem に結果を制限します。

  • totalBytesLess

    number 省略可

    totalBytes が指定された整数より小さい DownloadItem に結果を制限します。

  • URL

    文字列 省略可

    このダウンロードが開始された絶対 URL（リダイレクト前）。

  • urlRegex

    文字列 省略可

    url が指定された正規表現に一致する DownloadItem に結果を制限します。

FilenameConflictAction

uniquify

重複を避けるため、filename はファイル名の拡張子の前にカウンタを含むように変更されます。

上書き

既存のファイルは新しいファイルで上書きされます。

プロンプト

ユーザーにファイル選択ダイアログが表示されます。

列挙型

"uniquify"

"overwrite"

"prompt"

FilenameSuggestion

プロパティ

  • conflictAction

    FilenameConflictAction 省略可

    filename がすでに存在する場合に実行するアクション。

  • filename

    文字列

    DownloadItem の新しいターゲット DownloadItem.filename。ユーザーのデフォルトのダウンロード ディレクトリからの相対パスとして指定します。サブディレクトリを含めることもできます。絶対パス、空のパス、後方参照「..」を含むパスは無視されます。拡張機能によって登録された onDeterminingFilename リスナーがある場合、filename は無視されます。

GetFileIconOptions

プロパティ

  • サイズ

    number 省略可

    返されるアイコンのサイズ（密度非依存ピクセル（DIP）単位）。16 または 32 のいずれかにする必要があります（デフォルトは 32）。高 DPI ディスプレイでは、返される画像はデバイスのスケーリング ファクタに応じてスケーリングされます（例: 2x ディスプレイでサイズ 32 の場合は 64x64 px）。バックグラウンド サービス ワーカーからの呼び出しは、デフォルトで 1 倍のスケールになります。

HeaderNameValuePair

プロパティ

  • name

    文字列

    HTTP ヘッダーの名前。

  • 値

    文字列

    HTTP ヘッダーの値。

HttpMethod

列挙型

"GET"

"POST"

InterruptReason

列挙型

"FILE_FAILED"

"FILE_ACCESS_DENIED"

"FILE_NO_SPACE"

"FILE_NAME_TOO_LONG"

"FILE_TOO_LARGE"

"FILE_VIRUS_INFECTED"

"FILE_TRANSIENT_ERROR"

"FILE_BLOCKED"

"FILE_SECURITY_CHECK_FAILED"

"FILE_TOO_SHORT"

"FILE_HASH_MISMATCH"

"FILE_SAME_AS_SOURCE"

"NETWORK_FAILED"

"NETWORK_TIMEOUT"

"NETWORK_DISCONNECTED"

"NETWORK_SERVER_DOWN"

"NETWORK_INVALID_REQUEST"

"SERVER_FAILED"

"SERVER_NO_RANGE"

"SERVER_BAD_CONTENT"

"SERVER_UNAUTHORIZED"

"SERVER_CERT_PROBLEM"

"SERVER_FORBIDDEN"

"SERVER_UNREACHABLE"

"SERVER_CONTENT_LENGTH_MISMATCH"

"SERVER_CROSS_ORIGIN_REDIRECT"

"USER_CANCELED"

"USER_SHUTDOWN"

"CRASH"

State

in_progress

ダウンロードは現在、サーバーからデータを受信しています。

interrupted

エラーにより、ファイルホストとの接続が切断されました。

完了

ダウンロードが正常に完了しました。

列挙型

"in_progress"

"interrupted"

"complete"

StringDelta

プロパティ

  • 現在

    文字列 省略可

  • 前へ

    文字列 省略可

UiOptions

Chrome 105 以降 Chrome 148 以降の browser.*

プロパティ

  • 有効

    ブール値

    ダウンロード UI を有効または無効にします。

メソッド

acceptDanger()

browser.downloads.acceptDanger(
  downloadId: number,
): Promise<void>

危険なダウンロードを許可するようユーザーに求める。表示されているコンテキスト（タブ、ウィンドウ、ページ / ブラウザのアクション ポップアップ）からのみ呼び出すことができます。危険なダウンロードを自動的に受け入れない。ダウンロードが承認されると、onChanged イベントが発生します。承認されない場合は何も起こりません。すべてのデータが一時ファイルに取得され、ダウンロードが危険でないか、危険が受け入れられた場合、一時ファイルの名前がターゲット ファイル名に変更され、state が「complete」に変わり、onChanged が起動します。

パラメータ

戻り値

  • Promise<void>

    Chrome 96 以降 Chrome 148 以降の browser.*

    危険プロンプト ダイアログが閉じると解決される Promise を返します。

cancel()

browser.downloads.cancel(
  downloadId: number,
): Promise<void>

ダウンロードをキャンセルする。callback の実行時に、ダウンロードがキャンセル、完了、中断されたか、存在しなくなっています。

パラメータ

  • downloadId

    数値

    キャンセルするダウンロードの ID。

戻り値

  • Promise<void>

    Chrome 96 以降 Chrome 148 以降の browser.*

    キャンセル リクエストが完了すると解決される Promise を返します。

download()

browser.downloads.download(
  options: DownloadOptions,
): Promise<number>

URL をダウンロードします。URL で HTTP[S] プロトコルが使用されている場合、リクエストには、そのホスト名に現在設定されているすべての Cookie が含まれます。filename と saveAs の両方が指定されている場合は、[名前を付けて保存] ダイアログが表示され、指定された filename が事前入力されます。ダウンロードが正常に開始されると、新しい DownloadItem の downloadId を指定して callback が呼び出されます。ダウンロードの開始時にエラーが発生した場合、callback は downloadId=undefined で呼び出され、runtime.lastError には説明文字列が含まれます。エラー文字列は、リリース間で下位互換性が維持されるとは限りません。拡張機能はこれを解析してはなりません。

パラメータ

  • オプション

    DownloadOptions

    ダウンロードする対象と方法。

戻り値

  • Promise<number>

    Chrome 96 以降 Chrome 148 以降の browser.*

    新しい DownloadItem の ID で解決される Promise を返します。

erase()

browser.downloads.erase(
  query: DownloadQuery,
): Promise<number[]>

ダウンロードしたファイルを削除せずに、一致する DownloadItem を履歴から消去します。query に一致する DownloadItem ごとに onErased イベントが発生し、callback が呼び出されます。

パラメータ

戻り値

  • Promise<number[]>

    Chrome 96 以降 Chrome 148 以降の browser.*

getFileIcon()

browser.downloads.getFileIcon(
  downloadId: number,
  options?: GetFileIconOptions,
): Promise<string | undefined>

指定されたダウンロードのアイコンを取得します。新しいダウンロードの場合、ダウンロードのターゲット ファイル名が決定された後（たとえば、filename の変更により onChanged が起動されたとき）に、ファイル アイコンを使用できます。ファイル名が決定される前にアイコンを取得しようとすると、runtime.lastError でエラーが発生します。ダウンロードの進行中にこの関数から返される画像は、ダウンロードの完了後に返される画像とは異なる場合があります。アイコンの取得は、プラットフォームに応じて、基盤となるオペレーティング システムまたはツールキットにクエリを実行することで行われます。そのため、返されるアイコンは、ダウンロードの状態、プラットフォーム、登録されているファイル形式、ビジュアル テーマなど、さまざまな要因によって異なります。ファイル アイコンを特定できない場合、runtime.lastError にはエラー メッセージが含まれます。

パラメータ

  • downloadId

    数値

    ダウンロードの識別子。

  • オプション

    GetFileIconOptions 省略可

戻り値

  • Promise<string | undefined>

    Chrome 96 以降 Chrome 148 以降の browser.*

    ダウンロードを表す画像の URL で解決される Promise を返します。

open()

browser.downloads.open(
  downloadId: number,
): Promise<void>

DownloadItem が完了している場合は、ダウンロードしたファイルを今すぐ開きます。完了していない場合は、runtime.lastError を介してエラーを返します。このメソッドには、"downloads" 権限に加えて "downloads.open" 権限が必要です。アイテムが初めて開かれたときに、onChanged イベントが発生します。このメソッドは、ユーザー ジェスチャーに応じてのみ呼び出すことができます。

パラメータ

  • downloadId

    数値

    ダウンロードしたファイルの識別子。

戻り値

  • Promise<void>

    Chrome 123 以降 Chrome 148 以降の browser.*

pause()

browser.downloads.pause(
  downloadId: number,
): Promise<void>

ダウンロードを一時停止します。リクエストが成功すると、ダウンロードは一時停止状態になります。それ以外の場合、runtime.lastError にはエラー メッセージが含まれます。ダウンロードがアクティブでない場合、リクエストは失敗します。

パラメータ

  • downloadId

    数値

    一時停止するダウンロードの ID。

戻り値

  • Promise<void>

    Chrome 96 以降 Chrome 148 以降の browser.*

    一時停止リクエストが完了すると解決される Promise を返します。

removeFile()

browser.downloads.removeFile(
  downloadId: number,
): Promise<void>

ダウンロードしたファイルが存在し、DownloadItem が完了している場合は、ダウンロードしたファイルを削除します。それ以外の場合は、runtime.lastError を介してエラーを返します。

パラメータ

  • downloadId

    数値

戻り値

  • Promise<void>

    Chrome 96 以降 Chrome 148 以降の browser.*

resume()

browser.downloads.resume(
  downloadId: number,
): Promise<void>

一時停止したダウンロードを再開します。リクエストが成功すると、ダウンロードが進行中になり、一時停止が解除されます。それ以外の場合、runtime.lastError にはエラー メッセージが含まれます。ダウンロードがアクティブでない場合、リクエストは失敗します。

パラメータ

  • downloadId

    数値

    再開するダウンロードの ID。

戻り値

  • Promise<void>

    Chrome 96 以降 Chrome 148 以降の browser.*

    再開リクエストが完了すると解決される Promise を返します。

browser.downloads.search(
  query: DownloadQuery,
): Promise<DownloadItem[]>

DownloadItem を探します。すべての DownloadItem を取得するには、query を空のオブジェクトに設定します。特定の DownloadItem を取得するには、id フィールドのみを設定します。多数のアイテムをページングするには、orderBy: ['-startTime'] を設定し、limit を 1 ページあたりのアイテム数に設定し、startedAfter を最後のページの最後のアイテムの startTime に設定します。

パラメータ

戻り値

  • Promise<DownloadItem[]>

    Chrome 96 以降 Chrome 148 以降の browser.*

setShelfEnabled()

Chrome 117 以降、非推奨
browser.downloads.setShelfEnabled(
  enabled: boolean,
): void

代わりに setUiOptions を使用してください。

現在のブラウザ プロファイルに関連付けられているすべてのウィンドウの下部にあるグレーのシェルフを有効または無効にします。シェルフは、少なくとも 1 つの拡張機能で無効にされている限り、無効になります。少なくとも 1 つの他の拡張機能がシェルフを無効にしているときにシェルフを有効にすると、runtime.lastError を介してエラーが返されます。"downloads" 権限に加えて "downloads.shelf" 権限が必要です。

パラメータ

  • 有効

    ブール値

setUiOptions()

Chrome 105 以降 Chrome 148 以降の browser.* 
browser.downloads.setUiOptions(
  options: UiOptions,
): Promise<void>

現在のブラウザ プロファイルに関連付けられているすべてのウィンドウのダウンロード UI を変更します。少なくとも 1 つの拡張機能で UiOptions.enabled が false に設定されている限り、ダウンロード UI は非表示になります。他の拡張機能が少なくとも 1 つ無効にしているときに UiOptions.enabled を true に設定すると、runtime.lastError を介してエラーが返されます。"downloads" 権限に加えて "downloads.ui" 権限が必要です。

パラメータ

  • オプション

    UiOptions

    ダウンロード UI の変更をカプセル化します。

戻り値

  • Promise<void>

    UI の更新が完了したときに解決される Promise を返します。

show()

browser.downloads.show(
  downloadId: number,
): void

ダウンロードしたファイルをファイル マネージャーのフォルダに表示します。

パラメータ

  • downloadId

    数値

    ダウンロードしたファイルの識別子。

showDefaultFolder()

browser.downloads.showDefaultFolder(): void

ファイル マネージャーにデフォルトのダウンロード フォルダを表示します。

イベント

onChanged

browser.downloads.onChanged.addListener(
  callback: function,
)

bytesReceived と estimatedEndTime を除く DownloadItem のプロパティのいずれかが変更されると、このイベントが downloadId と変更されたプロパティを含むオブジェクトとともに呼び出されます。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (downloadDelta: DownloadDelta) => void

onCreated

browser.downloads.onCreated.addListener(
  callback: function,
)

ダウンロードの開始時に、DownloadItem オブジェクトとともに発生します。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (downloadItem: DownloadItem) => void

onDeterminingFilename

browser.downloads.onDeterminingFilename.addListener(
  callback: function,
)

ファイル名の決定プロセス中に、拡張機能はターゲットの DownloadItem.filename をオーバーライドできます。各拡張機能は、このイベントに複数のリスナーを登録することはできません。各リスナーは、同期または非同期で suggest を 1 回だけ呼び出す必要があります。リスナーが suggest を非同期で呼び出す場合は、true を返す必要があります。リスナーが suggest を同期的に呼び出さず、true を返さない場合、suggest は自動的に呼び出されます。すべてのリスナーが suggest を呼び出すまで、DownloadItem は完了しません。リスナーは、引数なしで suggest を呼び出して、ダウンロードでファイル名に downloadItem.filename を使用できるようにするか、suggestion オブジェクトを suggest に渡して、ターゲット ファイル名をオーバーライドできます。複数の拡張機能がファイル名をオーバーライドする場合、リスナーが suggestion オブジェクトを suggest に渡す、最後にインストールされた拡張機能が優先されます。どの拡張機能が優先されるかについて混乱を避けるため、ユーザーは競合する可能性のある拡張機能をインストールしないでください。ダウンロードが download によって開始され、MIME タイプと仮のファイル名が決定される前にターゲットのファイル名がわかっている場合は、代わりに filename を download に渡します。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (downloadItem: DownloadItem, suggest: function) => void

onErased

browser.downloads.onErased.addListener(
  callback: function,
)

ダウンロードが履歴から消去されると、downloadId とともに発生します。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (downloadId: number) => void

    • downloadId

      数値