downloads.cancel()

Функция cancel() API downloads отменяет загрузку. Вызов завершится ошибкой, если загрузка не активна, например, если она уже завершена.

Это асинхронная функция, которая возвращает Promise.

Синтаксис

let canceling = browser.downloads.cancel(
  downloadId      // integer
)

Параметры

downloadId: integer. Идентификатор загрузки, которую необходимо отменить.

Возвращаемое значение

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

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

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

Примеры

let downloadId = 13;

function onCanceled() {
  console.log(`Canceled download`);
}

function onError(error) {
  console.log(`Error: ${error}`);
}

let canceling = browser.downloads.cancel(downloadId);
canceling.then(onCanceled, onError);

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