拡張機能にブラウザーのダウンロードマネージャーとのやりとりを可能にします。このAPI モジュールを、ファイルマネージャーでのファイルのダウンロード、キャンセル、停止、ダウンロードの再開、ダウンロード済みのファイルの表示に使用できます。

このAPIを使うには manifest.json ファイルで指定する "downloads" API パーミッションが必要です。

downloads.FilenameConflictAction
ダウンロードされたファイル名が既存ファイルと衝突する場合の動作オプション定義
downloads.InterruptReason
ダウンロードが中断された理由の集合を定義
downloads.DangerType
ダウンロード可能なファイルに関連した想定される危険性への警告の集合を定義
downloads.State
現在のダウンロードが取りうるさまざまな状態を定義
downloads.DownloadItem
ダウンロード済みのファイルを表現する
downloads.StringDelta
2つの文字列の差異を表現する
downloads.DoubleDelta
2つの倍精度実数の差異を表現する
downloads.BooleanDelta
2つの真偽値の差異を表現する
downloads.DownloadTime
ダウンロード完了にかかった時間を表現する
downloads.DownloadQuery
ダウンロードマネージャーで特定のダウンロードを検索するのに使われるパラメーターを定義

関数

downloads.download()
URL とオプション設定を与えて、ファイルをダウンロードします
downloads.search()
ブラウザーのダウンロードマネージャーで使える DownloadItems に問い合わせて、指定した検索条件にマッチするものを返します
downloads.pause()
ダウンロードを停止します
downloads.resume()
停止したダウンロードを再開します
downloads.cancel()
ダウンロードをキャンセルします
downloads.getFileIcon()
指定したダウンロードのアイコンを取得します
downloads.open()
関連付けられたアプリケーションでダウンロード済みのファイルを開きます
downloads.show()
プラットフォームのファイルマネージャーアプリケーションを開いて、ダウンロードフォルダー内のファイルを表示します
downloads.showDefaultFolder()
プラットフォームのファイルマネージャーアプリケーションを開いて、デフォルトのダウンロードフォルダーを表示します
downloads.erase()
ダウンロード済みのファイルをディスクから消去することなく、ブラウザーのダウンロード履歴からマッチした DownloadItems を消去します
downloads.removeFile()
ブラウザーのダウンロード履歴ではなく、ダウンロード済みのファイルをディスクから消去します
downloads.acceptDanger()
危険なダウンロードを受け入れるかキャンセルするかを、ユーザーに確認します
downloads.drag()
ダウンロード済みのファイルを他のアプリケーションにドラッグし始めます
downloads.setShelfEnabled()
現在のブラウザープロファイルに関連するすぺてのウィンドウの下のグレーの棚を有効化/無効化します。この棚は少なくとも1つの拡張機能が無効化すると無効になります。

イベント

downloads.onCreated
ダウンロード開始時に DownloadItem オブジェクトと共に発火します
downloads.onErased
ダウンロードが履歴から消去された時に downloadId と共に発火します
downloads.onChanged
bytesReceived を除くいかなる DownloadItem のプロパティが変わった時、このイベントは downloadId や変更したプロパティを含むオブジェクトと共に発火します

ブラウザ実装状況

ChromeEdgeFirefoxFirefox for AndroidOpera
BooleanDelta あり なし4748 あり
DangerType あり なし4748 あり
DoubleDelta あり なし4748 あり
DownloadQuery あり なし4748 あり
DownloadTime あり なし4748 あり
FilenameConflictAction あり なし4748 あり
InterruptReason あり なし4748 あり
State あり なし4748 あり
StringDelta あり なし4748 あり
acceptDanger あり なし なし なし あり
cancel あり なし4848 あり
download あり なし4748 あり
drag あり なし なし なし あり
erase あり なし4848 あり
getFileIcon あり なし48 なし あり
onChanged あり なし4748 あり
onCreated あり なし4848 あり
onErased あり なし4848 あり
open あり なし4848 あり
pause あり なし4848 あり
removeFile あり なし4848 あり
resume あり なし4848 あり
search あり なし4748 あり
setShelfEnabled あり なし なし なし あり
show あり なし4848 あり
showDefaultFolder あり なし4848 あり

Example extensions

謝辞

この API は Chromium の chrome.downloads API に基づいています。

Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。

 

ドキュメントのタグと貢献者

このページの貢献者: Uemmra3
最終更新者: Uemmra3,