downloads.removeFile()

Функция removeFile() API downloads удаляет загруженный файл с диска.

Этот API удаляет файл с диска, но не удаляет его из истории загрузок браузера, поэтому вызов downloads.search() по-прежнему вернёт элемент как DownloadItem, но его атрибут exists будет false.

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

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

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

Синтаксис

let removing = browser.downloads.removeFile(
  downloadId      // integer
)

Параметры

downloadId: Значение integer представляющее идентификатор DownloadItem, который нужно удалить с диска.

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

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

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

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

Примеры

Удалить последний загруженный файл:

function onRemoved() {
  console.log(`Removed item`);
}

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

function remove(downloadItems) {
  if (downloadItems.length > 0) {
    let removing = browser.downloads.removeFile(downloadItems[0].id);
    removing.then(onRemoved, onError);
  }
}

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

searching.then(remove, 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/removeFile