downloads.erase()

Die erase() Funktion der downloads API entfernt passende DownloadItems aus dem Download-Verlauf des Browsers, ohne die heruntergeladenen Dateien von der Festplatte zu löschen.

Um die Dateien von der Festplatte zu entfernen, müssen Sie downloads.removeFile() verwenden.

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

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

Syntax

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

Parameter

query

Ein downloads.DownloadQuery Objekt.

Rückgabewert

Ein Promise. Wenn der Aufruf erfolgreich war, wird das Promise mit einem Array von ganzen Zahlen erfüllt, die die IDs der gelöschten DownloadItems darstellen. Wenn keine zum Abfrageparameter passenden Elemente gefunden werden konnten, wird das Array leer sein. Wenn der Aufruf fehlschlug, wird das Promise mit einer Fehlermeldung abgelehnt.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Das kürzlich heruntergeladene Element löschen:

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

Alles löschen:

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

Beispielerweiterungen

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