Spec-Zone.ru › Web Extensions

загрузки

Позволяет расширениям взаимодействовать с менеджером загрузок браузера. Вы можете использовать этот модуль 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 ? Нет ?

Примеры расширений

  • latest-download

Примечание: Этот 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API