downloads.onCreated

Событие onCreated() API downloads срабатывает при начале загрузки, т.е. когда успешно вызывается downloads.download().

Слушателю передается объект downloads.DownloadItem в качестве параметра.

Синтаксис

browser.downloads.onCreated.addListener(listener)
browser.downloads.onCreated.removeListener(listener)
browser.downloads.onCreated.hasListener(listener)

События имеют три функции:

addListener(callback): Добавляет слушателя к этому событию.
removeListener(listener): Прекращает прослушивание этого события. Аргумент listener — это слушатель, который нужно удалить.
hasListener(listener): Проверяет, зарегистрирован ли данный listener для этого события. Возвращает true если он прослушивает, false в противном случае.

Синтаксис addListener

Параметры

function

Функция обратного вызова, которая будет вызвана при возникновении этого события. Эта функция получит следующие аргументы:

downloadItem: Объект downloads.DownloadItem.

Совместимость с браузерами

	Рабочие столы						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`onCreated`	Да	79	48	?	Да	Нет	?	?	48–79	?	Нет	?

Примеры

Вывести URL загружаемых элементов:

function handleCreated(item) {
  console.log(item.url);
}

browser.downloads.onCreated.addListener(handleCreated);

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