downloads.removeFile()

Die Funktion removeFile() der downloads API entfernt eine heruntergeladene Datei von der Festplatte.

Diese API entfernt die Datei von der Festplatte, löscht sie jedoch nicht aus dem Download-Verlauf des Browsers. Ein Aufruf von downloads.search() wird daher das Element weiterhin als DownloadItem zurückgeben, aber das Attribut exists wird false sein.

Um eine Datei aus dem Download-Verlauf zu entfernen, müssen Sie downloads.erase() verwenden.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Hinweis: Wenn Sie eine heruntergeladene Datei von der Festplatte und aus dem Verlauf löschen möchten, müssen Sie removeFile() aufrufen, bevor Sie downloads.erase() aufrufen. Wenn Sie es andersherum versuchen, erhalten Sie einen Fehler beim Aufruf von removeFile(), da der Browser keinen Eintrag des Downloads mehr hat.

Syntax

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

Parameter

downloadId

Ein integer, der die ID des DownloadItem darstellt, das Sie von der Festplatte löschen möchten.

Rückgabewert

Ein Promise. Wenn die Anfrage erfolgreich war, wird das Promise ohne Argumente erfüllt. Wenn die Anfrage fehlgeschlagen ist, wird das Promise mit einer Fehlermeldung abgelehnt.

Beispiele

Die zuletzt heruntergeladene Datei entfernen:

js
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);

Beispielerweiterungen

Browser-Kompatibilität

Hinweis: Diese API basiert auf der chrome.downloads API von Chromium.