загрузки
Позволяет расширениям взаимодействовать с менеджером загрузок браузера. Вы можете использовать этот модуль API для загрузки файлов, отмены, приостановки, возобновления загрузок и отображения загруженных файлов в файловом менеджере.
Для использования этого API необходимо указать разрешение «загрузки» API-разрешение в вашем файле manifest.json.
Типы
downloads.FilenameConflictAction-
Определяет варианты действий при конфликте имени загружаемого файла с существующим файлом.
downloads.InterruptReason-
Определяет набор возможных причин прерывания загрузки.
downloads.DangerType-
Определяет набор распространённых предупреждений о потенциальных опасностях, связанных с загружаемыми файлами.
downloads.State-
Определяет различные состояния, в которых может находиться текущая загрузка.
downloads.DownloadItem-
Представляет загружаемый файл.
downloads.StringDelta-
Представляет разницу между двумя строками.
downloads.DoubleDelta-
Представляет разницу между двумя числами с плавающей запятой.
downloads.BooleanDelta-
Представляет разницу между двумя булевыми значениями.
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()-
Включает или отключает серую панель внизу каждого окна, связанного с текущим профилем браузера. Панель будет отключена, пока хотя бы одно расширение не включит её.
События
downloads.onCreated-
Вызывается с объектом
DownloadItem, когда начинается загрузка. downloads.onErased-
Вызывается с
downloadIdпри удалении загрузки из истории. downloads.onChanged-
Когда любое из свойств
DownloadItem, кромеbytesReceived, изменяется, срабатывает это событие сdownloadIdи объектом, содержащим изменённые свойства.
Совместимость с браузерами
| Рабочий стол | Мобильный | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | |
BooleanDelta |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
DangerType |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
DoubleDelta |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
DownloadQuery |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
DownloadTime |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
FilenameConflictAction |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
InterruptReason |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
State |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
StringDelta |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
acceptDanger |
Да | 79 | Нет | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
cancel |
Да | 79 | 48 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
download |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
drag |
Да | 79 | Нет | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
erase |
Да | 79 | 48 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
getFileIcon |
Да | 79 | 48 | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
onChanged |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
onCreated |
Да | 79 | 48 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
onErased |
Да | 79 | 48 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
open |
Да | 79 | 48 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
pause |
Да | 79 | 48 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
removeFile |
Да | 79 | 48 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
resume |
Да | 79 | 48 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
search |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
setShelfEnabled |
Да | 79 | Нет | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
show |
Да | 79 | 48 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
showDefaultFolder |
Да | 79 | 48 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
Примеры расширений
Примечание: Этот API основан на API chrome.downloads Chromium.
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/downloads