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
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:
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:
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);
Beispiel-Erweiterungen
Hinweis: Diese API basiert auf der chrome.downloads
API von Chromium.