downloads.erase()

Функция erase() API downloads удаляет соответствующие элементы DownloadItems из истории загрузок браузера, не удаляя загруженные файлы с диска.

Чтобы удалить файлы с диска, необходимо использовать downloads.removeFile().

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

Примечание: Если вы хотите удалить загруженный файл с диска и удалить его из истории, необходимо вызвать downloads.removeFile() перед вызовом erase(). Если вы попытаетесь сделать это в обратном порядке, при вызове downloads.removeFile() возникнет ошибка, так как файл больше не существует в соответствии с браузером.

Синтаксис

let erasing = browser.downloads.erase(
  query                    // DownloadQuery
)

Параметры

query: Объект downloads.DownloadQuery.

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

A Promise. Если вызов был успешным, промис будет выполнен с массивом целых чисел, представляющих идентификаторы удалённых DownloadItems. Если по заданному параметру запроса не найдено соответствующих элементов, массив будет пустым. Если вызов завершился неудачно, промис будет отклонен с сообщением об ошибке.

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

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

Примеры

Удалить последнюю загрузку:

function onErased(ids) {
  console.log(`Erased: ${ids}`);
}

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

let erasing = browser.downloads.erase({
  limit: 1,
  orderBy: ["-startTime"]
});

erasing.then(onErased, onError);

Удалить всё:

function onErased(ids) {
  console.log(`Erased: ${ids}`);
}

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

let erasing = browser.downloads.erase({});
erasing.then(onErased, onError);

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

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/erase