chrome.downloads

refresh date: 2026-09-25 robots: noindex

Это разрешение вызывает предупреждение.

Описание

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

Разрешения

downloads

Манифест

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

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

Примеры

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

Типы

BooleanDelta

Свойства

  • сила тока

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

  • Назад

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

DangerType

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

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

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

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

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

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

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

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 и более поздние версии

    Изменение в 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 и более поздних версий;

    Абсолютный 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

    строка необязательно

    Путь к файлу относительно каталога Downloads, в котором будет храниться скачанный файл. Может содержать подкаталоги. Абсолютные пути, пустые пути и пути, содержащие обратные ссылки "..", вызовут ошибку. 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 и более поздних версий;

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

  • finalUrlRegex

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

    Chrome 54 и более поздних версий;

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

  • id

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

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

  • лимит

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

    Максимальное количество возвращаемых совпадений DownloadItem. Значение по умолчанию – 1000. Чтобы вернуть все подходящие DownloadItem, задайте значение 0. Подробнее о том, как просматривать результаты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.

  • штат

    Штат (необязательный)

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

  • 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 на экране с коэффициентом 2). Для вызовов из фоновых служб по умолчанию используется масштаб 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 и более поздних версий;

Свойства

  • включено

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

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

Методы

acceptDanger()

Promise 
chrome.downloads.acceptDanger(
  downloadId: number,
  callback?: function,
): Promise<void>

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

Параметры

  • downloadId

    число

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

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

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

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

    () =& gt;void

Возвраты

  • Promise<void>

    Chrome 96 и более поздних версий.

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

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

cancel()

Promise 
chrome.downloads.cancel(
  downloadId: number,
  callback?: function,
): Promise<void>

Отменить скачивание. Когда выполняется команда callback, скачивание отменяется, завершается, прерывается или уже не существует.

Параметры

  • downloadId

    число

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

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

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

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

    () =& gt;void

Возвраты

  • Promise<void>

    Chrome 96 и более поздних версий.

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

    Обещания поддерживаются только в Manifest V3 и более поздних версиях. На других платформах необходимо использовать обратные вызовы.

download()

Promise 
chrome.downloads.download(
  options: DownloadOptions,
  callback?: function,
): Promise<number>

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

Параметры

  • Параметры

    DownloadOptions

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

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

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

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

    (downloadId: number) =& gt;void

    • downloadId

      число

Возвраты

  • Promise<number>

    Chrome 96 и более поздние версии

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

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

erase()

Promise 
chrome.downloads.erase(
  query: DownloadQuery,
  callback?: function,
): Promise<number[]>

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

Параметры

  • запрос

    DownloadQuery

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

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

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

    (erasedIds: number[]) =& gt;void

    • erasedIds

      number[]

Возвраты

  • Promise<number[]>

    Chrome 96 и более поздних версий.

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getFileIcon()

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

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

Параметры

  • downloadId

    число

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

  • Параметры

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

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

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

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

    (iconURL?: string) =& gt;void

    • iconURL

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

Возвраты

  • Promise<string | undefined>

    Chrome 96 и более поздние версии

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

    Обещания поддерживаются только в Manifest V3 и более поздних версиях. На других платформах необходимо использовать обратные вызовы.

open()

Promise 
chrome.downloads.open(
  downloadId: number,
  callback?: function,
): Promise<void>

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

Параметры

  • downloadId

    число

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

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

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

    Chrome 123 и более поздних версий

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

    () =& gt;void

Возвраты

  • Promise<void>

    Chrome 123 и более поздние версии

    Обещания поддерживаются только в Manifest V3 и более поздних версиях. На других платформах необходимо использовать обратные вызовы.

pause()

Promise 
chrome.downloads.pause(
  downloadId: number,
  callback?: function,
): Promise<void>

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

Параметры

  • downloadId

    число

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

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

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

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

    () =& gt;void

Возвраты

  • Promise<void>

    Chrome 96 и более поздних версий.

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

    Обещания поддерживаются только в Manifest V3 и более поздних версиях. На других платформах необходимо использовать обратные вызовы.

removeFile()

Promise 
chrome.downloads.removeFile(
  downloadId: number,
  callback?: function,
): Promise<void>

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

Параметры

  • downloadId

    число

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

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

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

    () =& gt;void

Возвраты

  • Promise<void>

    Chrome 96 и более поздних версий.

    Обещания поддерживаются только в Manifest V3 и более поздних версиях. На других платформах необходимо использовать обратные вызовы.

resume()

Promise 
chrome.downloads.resume(
  downloadId: number,
  callback?: function,
): Promise<void>

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

Параметры

  • downloadId

    число

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

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

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

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

    () =& gt;void

Возвраты

  • Promise<void>

    Chrome 96 и более поздних версий.

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

    Обещания поддерживаются только в Manifest V3 и более поздних версиях. На других платформах необходимо использовать обратные вызовы.

Promise 
chrome.downloads.search(
  query: DownloadQuery,
  callback?: function,
): Promise<DownloadItem[]>

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

Параметры

  • запрос

    DownloadQuery

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

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

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

    (results: DownloadItem[]) =& gt;void

Возвраты

  • Promise<DownloadItem[]>

    Chrome 96 и более поздних версий.

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

setShelfEnabled()

Устарело в Chrome 117
chrome.downloads.setShelfEnabled(
  enabled: boolean,
): void

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

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

Параметры

  • включено

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

setUiOptions()

Promise Chrome 105 и более поздние версии 
chrome.downloads.setUiOptions(
  options: UiOptions,
  callback?: function,
): Promise<void>

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

Параметры

  • Параметры

    UiOptions

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

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

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

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

    () =& gt;void

Возвраты

  • Promise<void>

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

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

show()

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

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

Параметры

  • downloadId

    число

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

showDefaultFolder()

chrome.downloads.showDefaultFolder(): void

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

События

onChanged

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

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

Параметры

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

    function

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

    (downloadDelta: DownloadDelta) =& gt;void

onCreated

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

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

Параметры

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

    function

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

    (downloadItem: DownloadItem) =& gt;void

onDeterminingFilename

chrome.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) =& gt;void

    • downloadItem

      DownloadItem

    • подсказки

      function

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

      (suggestion?: FilenameSuggestion) =& gt;void

onErased

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

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

Параметры

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

    function

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

    (downloadId: number) =& gt;void

    • downloadId

      число