browser.downloads

Описание

Используйте chrome.downloads API, чтобы программно запускать, отслеживать, изменять и искать скачивания.

Разрешения

downloads

Чтобы использовать этот API, необходимо объявить разрешение "downloads" в манифесте расширения.

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

Примеры

Простые примеры использования browser.downloads API можно найти в каталоге examples/api/downloads. Другие примеры и инструкции по просмотру исходного кода можно найти в разделе Примеры.

Типы

BooleanDelta

Свойства

• сила тока

  Логическое значение (необязательно)

• Назад

  Логическое значение (необязательно)

DangerType

Перечисление

"file"
Название скачиваемого файла подозрительно.

"url"
URL скачивания известен как вредоносный.

"content"
Скачанный файл является вредоносным.

"uncommon"
URL скачивания используется редко и может быть опасен.

host
Файл скачан с хоста, который распространяет вредоносные двоичные файлы и, скорее всего, опасен.

"unwanted"
Скачивание потенциально нежелательного или небезопасного файла. Например, оно может изменить настройки браузера или компьютера.

safe
Скачиваемый файл не представляет известной угрозы для компьютера пользователя.

accepted
Пользователь принял опасное скачивание.

"allowlistedByPolicy"
Значения, связанные с корпоративными аккаунтами.

"asyncScanning"

"asyncLocalPasswordScanning"

"passwordProtected"

"blockedTooLarge"

"sensitiveContentWarning"

"sensitiveContentBlock"

"deepScannedFailed"

"deepScannedSafe"

"deepScannedOpenedDangerous"

promptForScanning

"promptForLocalPasswordScanning"

"accountCompromise"

"blockedScanFailed"

"forceSaveToGdrive"
Используется расширением Secure Enterprise Browser. При необходимости 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+ browser.* начиная с Chrome 148

  Изменение finalUrl (если есть).

• id

  число

  id DownloadItem, который был изменен.

• передразниваю

  StringDelta необязательный

  Изменение mime (если есть).

• приостановлено

  BooleanDelta необязательный

  Изменение paused (если есть).

• startTime

  StringDelta необязательный

  Изменение startTime (если есть).

• штат

  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 секунд.

• fileSize

  число

  Количество байтов во всем файле после распаковки или -1, если оно неизвестно.

• filename

  string

  Абсолютный локальный путь.

• finalUrl

  string

  Chrome 54+ browser.* начиная с Chrome 148

  Абсолютный URL, с которого выполняется скачивание, после всех переадресаций.

• id

  число

  Идентификатор, который сохраняется в разных сеансах браузера.

• инкогнито

  Логическое значение

  Значение false, если скачивание записано в истории, и true, если нет.

• передразниваю

  string

  MIME-тип файла.

• приостановлено

  Логическое значение

  True, если скачивание прекратило считывать данные с хоста, но подключение осталось открытым.

• URL перехода

  string

  Абсолютный URL.

• startTime

  string

  Время начала скачивания в формате ISO 8601. Может быть передано непосредственно в конструктор Date: chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})})

• штат

  Состояние

  Указывает, выполняется ли скачивание, прервано оно или завершено.

• totalBytes

  число

  Количество байтов во всем файле без учета сжатия или -1, если оно неизвестно.

• url

  string

  Абсолютный URL, с которого было инициировано скачивание, до всех переадресаций.

DownloadOptions

Свойства

• body

  Строка (необязательно)

  Текст записи.

• conflictAction

  FilenameConflictAction необязательный

  Действие, которое нужно выполнить, если filename уже существует.

• filename

  Строка (необязательно)

  Путь к файлу относительно каталога "Скачанные файлы", в котором будет храниться скачанный файл. Может содержать подкаталоги. Абсолютные пути, пустые пути и пути, содержащие обратные ссылки "..", вызовут ошибку. onDeterminingFilename позволяет предложить название файла после того, как будут определены MIME-тип и предварительное название файла.

• headers

  HeaderNameValuePair[] необязательный

  Дополнительные HTTP-заголовки, которые нужно отправить с запросом, если URL использует протокол HTTP[s]. Каждый заголовок представлен в виде словаря, содержащего ключи name и value или binaryValue, ограниченные теми, которые разрешены XMLHttpRequest.

• method

  HttpMethod необязательный

  Метод HTTP, который будет использоваться, если URL использует протокол HTTP[S].

• saveAs

  Логическое значение (необязательно)

  Используйте средство выбора файлов, чтобы пользователь мог выбрать название файла независимо от того, задано ли значение filename или оно уже существует.

• url

  string

  URL для скачивания.

DownloadQuery

Свойства

• bytesReceived

  number (необязательно)

  Количество байтов, полученных от хоста, без учета сжатия файлов.

• опасность

  DangerType необязательный

  Указание на то, считается ли скачивание безопасным или подозрительным.

• endTime

  Строка (необязательно)

  Время окончания скачивания в формате ISO 8601.

• endedAfter

  Строка (необязательно)

  Ограничивает результаты DownloadItem, которые закончились после указанного времени в миллисекундах в формате ISO 8601.

• endedBefore

  Строка (необязательно)

  Ограничивает результаты DownloadItem, которые закончились до указанного времени в миллисекундах в формате ISO 8601.

• ошибка

  InterruptReason необязательно

  Почему скачивание было прервано.

• существует

  Логическое значение (необязательно)

  существует ли скачанный файл;

• fileSize

  number (необязательно)

  Количество байтов во всем файле после распаковки или -1, если оно неизвестно.

• filename

  Строка (необязательно)

  Абсолютный локальный путь.

• filenameRegex

  Строка (необязательно)

  Ограничивает результаты до DownloadItem, у которых filename соответствует заданному регулярному выражению.

• finalUrl

  Строка (необязательно)

  Chrome 54+ browser.* начиная с Chrome 148

  Абсолютный URL, с которого выполняется скачивание, после всех переадресаций.

• finalUrlRegex

  Строка (необязательно)

  Chrome 54+ browser.* начиная с Chrome 148

  Ограничивает результаты до DownloadItem, у которых finalUrl соответствует заданному регулярному выражению.

• id

  number (необязательно)

  id объекта DownloadItem, к которому выполняется запрос.

• лимит

  number (необязательно)

  Максимальное количество возвращаемых совпадающих объектов DownloadItem. Значение по умолчанию – 1000. Если задать значение 0, будут возвращены все подходящие DownloadItem. Подробнее о том, как просматривать результаты…search

• передразниваю

  Строка (необязательно)

  MIME-тип файла.

• orderBy

  string[] необязательно

  Чтобы отсортировать результаты поиска, задайте для элементов этого массива свойства DownloadItem. Например, если задать значение orderBy=['startTime'], DownloadItem будут отсортированы по времени начала в порядке возрастания. Чтобы указать порядок по убыванию, добавьте дефис: "-startTime".

• приостановлено

  Логическое значение (необязательно)

  True, если скачивание прекратило считывать данные с хоста, но подключение осталось открытым.

• запрос

  string[] необязательно

  Этот массив поисковых запросов ограничивает результаты до DownloadItem, у которых filename, url или finalUrl содержат все поисковые запросы, которые не начинаются с дефиса (-), и ни одного поискового запроса, который начинается с дефиса.

• startTime

  Строка (необязательно)

  Время начала скачивания в формате ISO 8601.

• startedAfter

  Строка (необязательно)

  Ограничивает результаты DownloadItem, которые начались после указанного времени в миллисекундах в формате ISO 8601.

• startedBefore

  Строка (необязательно)

  Ограничивает результаты DownloadItem, которые начались до указанного времени в миллисекундах в формате ISO 8601.

• штат

  State optional

  Указывает, выполняется ли скачивание, прервано оно или завершено.

• totalBytes

  number (необязательно)

  Количество байтов во всем файле без учета сжатия или -1, если оно неизвестно.

• totalBytesGreater

  number (необязательно)

  Ограничивает результаты объектами DownloadItem, у которых значение totalBytes больше указанного целого числа.

• totalBytesLess

  number (необязательно)

  Ограничивает результаты объектами DownloadItem, у которых значение totalBytes меньше указанного целого числа.

• url

  Строка (необязательно)

  Абсолютный URL, с которого было инициировано скачивание, до всех переадресаций.

• urlRegex

  Строка (необязательно)

  Ограничивает результаты до DownloadItem, у которых url соответствует заданному регулярному выражению.

FilenameConflictAction

uniquify

Чтобы избежать дублирования, в filename перед расширением добавляется счетчик.

перезаписать

Существующий файл будет перезаписан новым.

prompt

Пользователю будет предложено выбрать файл.

Перечисление

"uniquify"

"overwrite"

"prompt"

FilenameSuggestion

Свойства

• conflictAction

  FilenameConflictAction необязательный

  Действие, которое нужно выполнить, если filename уже существует.

• filename

  string

  Новый целевой DownloadItem.filename DownloadItem, указанный как путь относительно каталога "Скачанные файлы" пользователя по умолчанию. Может содержать подкаталоги. Абсолютные пути, пустые пути и пути, содержащие обратные ссылки "..", будут игнорироваться. filename игнорируется, если есть прослушиватели onDeterminingFilename, зарегистрированные расширениями.

GetFileIconOptions

Свойства

• размер

  number (необязательно)

  Размер возвращаемого значка в пикселях, не зависящих от плотности экрана (DIP). Допустимые значения: 16 или 32 (по умолчанию). На экранах с высокой плотностью пикселей возвращаемое изображение масштабируется с учетом коэффициента масштабирования устройства (например, 64 x 64 пикселя для размера 32 на экране с коэффициентом 2x). Для вызовов из фоновых сервисных скриптов по умолчанию используется масштаб 1x.

HeaderNameValuePair

Свойства

• name

  string

  Название HTTP-заголовка.

• value

  string

  Значение 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

Скачивание получает данные с сервера.

прервано

Произошла ошибка, из-за которой было прервано подключение к хосту файлов.

complete

Скачивание завершено.

Перечисление

"in_progress"

"interrupted"

"complete"

StringDelta

Свойства

• сила тока

  Строка (необязательно)

• Назад

  Строка (необязательно)

UiOptions

Chrome 105+ browser.* начиная с Chrome 148

Свойства

• включено

  Логическое значение

  Включить или отключить интерфейс скачивания.

Методы

acceptDanger()

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

Запрашивать у пользователя разрешение на скачивание опасного файла. Может вызываться только из видимого контекста (вкладки, окна или всплывающего окна страницы/браузера). Не принимает автоматически опасные скачивания. Если скачивание будет одобрено, активируется событие onChanged. В противном случае ничего не произойдет. Когда все данные будут получены во временный файл и скачивание не будет опасным или опасность будет принята, временный файл будет переименован в целевое название файла, state изменится на "complete" и сработает onChanged.

Параметры

• downloadId

  число

  Идентификатор DownloadItem.

Возвраты

• Promise<void>

  Chrome 96 и более поздние версии browser.* начиная с Chrome 148

  Возвращает объект Promise, который распознается, когда закрывается диалоговое окно с предупреждением об опасности.

cancel()

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

Отменить скачивание. При запуске callback скачивание отменено, завершено, прервано или больше не существует.

Параметры

• downloadId

  число

  Идентификатор скачивания, которое нужно отменить.

Возвраты

• Promise<void>

  Chrome 96 и более поздние версии browser.* начиная с Chrome 148

  Возвращает объект Promise, который распознается, когда запрос на отмену выполнен.

download()

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

Скачать URL. Если в URL используется протокол HTTP[S], то запрос будет включать все файлы cookie, заданные для имени хоста. Если заданы оба правила (filename и saveAs), откроется диалоговое окно "Сохранить как", в котором будет автоматически заполнено указанное значение правила filename. Если скачивание началось успешно, будет вызван метод callback с новым значением downloadId для DownloadItem. Если при запуске скачивания произошла ошибка, будет вызван метод callback с параметром downloadId=undefined, а runtime.lastError будет содержать строку с описанием. Мы не гарантируем, что строки ошибок будут совместимы с предыдущими версиями. Расширения не должны его анализировать.

Параметры

• Параметры

  DownloadOptions

  Что и как скачивать.

Возвраты

• Promise<number>

  Chrome 96 и более поздние версии browser.* начиная с Chrome 148

  Возвращает объект Promise, который распознается как идентификатор нового объекта DownloadItem.

erase()

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

Удалить DownloadItem из истории, не удаляя скачанный файл. Событие onErased будет активировано для каждого элемента DownloadItem, соответствующего query, а затем будет вызван метод callback.

Параметры

• запрос

  DownloadQuery

Возвраты

• Promise<number[]>

  Chrome 96 и более поздние версии browser.* начиная с Chrome 148

getFileIcon()

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

Получить значок для указанного скачивания. Для новых скачиваний значки файлов доступны после того, как определено название целевого файла (например, когда срабатывает onChanged с изменением filename). Попытка получить значок до определения названия файла приведет к ошибке runtime.lastError. Изображение, возвращаемое этой функцией во время скачивания, может отличаться от изображения, возвращаемого после завершения скачивания. Значок извлекается путем запроса к базовой операционной системе или набору инструментов в зависимости от платформы. Возвращаемый значок зависит от ряда факторов, включая состояние скачивания, платформу, зарегистрированные типы файлов и визуальную тему. Если значок файла определить не удается, runtime.lastError будет содержать сообщение об ошибке.

Параметры

• downloadId

  число

  Идентификатор скачивания.

• Параметры

  GetFileIconOptions необязательный

Возвраты

• Promise<string | undefined>

  Chrome 96 и более поздние версии browser.* начиная с Chrome 148

  Возвращает объект Promise, который распознается с URL изображения, представляющего скачивание.

open()

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

Открывает скачанный файл, если DownloadItem завершено. В противном случае возвращает ошибку через runtime.lastError. Для этого метода требуется разрешение "downloads.open" в дополнение к разрешению "downloads". Событие onChanged активируется, когда объект открывается в первый раз. Этот метод можно вызвать только в ответ на жест пользователя.

Параметры

• downloadId

  число

  Идентификатор скачанного файла.

Возвраты

• Promise<void>

  Chrome 123 и более поздние версии browser.* начиная с Chrome 148

pause()

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

Приостановить скачивание. Если запрос был успешным, скачивание приостанавливается. В противном случае runtime.lastError содержит сообщение об ошибке. Если скачивание неактивно, запрос не будет выполнен.

Параметры

• downloadId

  число

  Идентификатор скачивания, которое нужно приостановить.

Возвраты

• Promise<void>

  Chrome 96 и более поздние версии browser.* начиная с Chrome 148

  Возвращает объект Promise, который распознается, когда запрос на приостановку выполнен.

removeFile()

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

Удаляет скачанный файл, если он существует и DownloadItem завершено. В противном случае возвращает ошибку через runtime.lastError.

Параметры

• downloadId

  число

Возвраты

• Promise<void>

  Chrome 96 и более поздние версии browser.* начиная с Chrome 148

resume()

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

Возобновить скачивание. Если запрос выполнен успешно, скачивание возобновляется. В противном случае runtime.lastError содержит сообщение об ошибке. Если скачивание неактивно, запрос не будет выполнен.

Параметры

• downloadId

  число

  Идентификатор скачивания, которое нужно возобновить.

Возвраты

• Promise<void>

  Chrome 96 и более поздние версии browser.* начиная с Chrome 148

  Возвращает объект Promise, который распознается, когда запрос на возобновление выполнен.

search()

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

Найдите DownloadItem. Чтобы получить все DownloadItem, задайте для query пустой объект. Чтобы получить определенный объект DownloadItem, задайте только поле id. Чтобы пролистать большое количество элементов, задайте orderBy: ['-startTime'], установите для limit количество элементов на странице и задайте для startedAfter значение startTime последнего элемента с последней страницы.

Параметры

• запрос

  DownloadQuery

Возвраты

• Promise<DownloadItem[]>

  Chrome 96 и более поздние версии browser.* начиная с Chrome 148

setShelfEnabled()

Устарело с версии Chrome 117

browser.downloads.setShelfEnabled(
  enabled: boolean,
): void

Используйте вместо него setUiOptions.

Включить или отключить серую панель внизу каждого окна, связанного с текущим профилем браузера. Панель будет отключена, если ее отключит хотя бы одно расширение. Если включить панель, когда хотя бы одно другое расширение отключило ее, runtime.lastError вернет ошибку. Помимо разрешения "downloads", требуется разрешение "downloads.shelf".

Параметры

• включено

  Логическое значение

setUiOptions()

Chrome 105+ browser.* начиная с Chrome 148

browser.downloads.setUiOptions(
  options: UiOptions,
): Promise<void>

Изменяет интерфейс скачивания для каждого окна, связанного с текущим профилем браузера. Если хотя бы одно расширение установило для UiOptions.enabled значение false, интерфейс скачивания будет скрыт. Если задать для UiOptions.enabled значение true, когда хотя бы одно другое расширение отключило его, будет возвращена ошибка через runtime.lastError. Помимо разрешения "downloads", требуется разрешение "downloads.ui".

Параметры

• Параметры

  UiOptions

  Инкапсулировать изменение в интерфейсе скачивания.

Возвраты

• Promise<void>

  Возвращает объект Promise, который распознается, когда обновление интерфейса завершено.

show()

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

Показать скачанный файл в папке в файловом менеджере.

Параметры

• downloadId

  число

  Идентификатор скачанного файла.

showDefaultFolder()

browser.downloads.showDefaultFolder(): void

Показать папку "Скачанные файлы" по умолчанию в файловом менеджере.

События

onChanged

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

Когда меняется любое свойство DownloadItem, кроме bytesReceived и estimatedEndTime, это событие запускается с downloadId и объектом, содержащим измененные свойства.

Параметры

• обратный вызов

  function

  Параметр callback выглядит следующим образом:

  (downloadDelta: DownloadDelta) => void

  • downloadDelta

    DownloadDelta

onCreated

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

Это событие активируется с объектом DownloadItem, когда начинается скачивание.

Параметры

• обратный вызов

  function

  Параметр callback выглядит следующим образом:

  (downloadItem: DownloadItem) => void

  • downloadItem

    DownloadItem

onDeterminingFilename

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

В процессе определения имени файла расширениям будет предоставлена возможность переопределить целевой DownloadItem.filename. Каждое расширение может зарегистрировать не более одного прослушивателя для этого события. Каждый прослушиватель должен вызвать suggest ровно один раз, синхронно или асинхронно. Если прослушиватель вызывает suggest асинхронно, он должен возвращать true. Если прослушиватель не вызывает suggest синхронно и не возвращает true, то suggest будет вызван автоматически. DownloadItem не завершится, пока все прослушиватели не вызовут suggest. Прослушиватели могут вызывать suggest без аргументов, чтобы разрешить скачивание с использованием downloadItem.filename в качестве названия файла, или передавать объект suggestion в suggest, чтобы переопределить название целевого файла. Если несколько расширений переопределяют название файла, то приоритет имеет последнее установленное расширение, слушатель которого передает объект suggestion в suggest. Чтобы избежать путаницы, пользователям не следует устанавливать расширения, которые могут конфликтовать. Если скачивание инициировано download и целевое название файла известно до того, как определены MIME-тип и предварительное название файла, передайте filename в download.

Параметры

• обратный вызов

  function

  Параметр callback выглядит следующим образом:

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

  • downloadItem

    DownloadItem

  • подсказки

    function

    Параметр suggest выглядит следующим образом:

    (suggestion?: FilenameSuggestion) => void

    • подсказка

      FilenameSuggestion необязательный

onErased

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

Срабатывает с downloadId, когда скачивание удаляется из истории.

Параметры

• обратный вызов

  function

  Параметр callback выглядит следующим образом:

  (downloadId: number) => void

  • downloadId

    число