downloads.erase()
Die Funktion erase() 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 es laut dem Browser nicht mehr existiert.
Syntax
let erasing = browser.downloads.erase(
query // DownloadQuery
)
Parameter
query-
Ein
downloads.DownloadQueryObjekt.
Rückgabewert
Ein Promise. Wenn der Aufruf erfolgreich war, wird das Promise mit einem Array von Ganzzahlen erfüllt, die die IDs der gelöschten DownloadItems darstellen. Wenn keine Elemente gefunden werden konnten, die dem Parameter query entsprechen, wird das Array leer sein. Wenn der Aufruf fehlschlägt, wird das Promise mit einer Fehlermeldung abgelehnt.
Beispiele
Löschen Sie den neuesten Download:
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);
Beispielerweiterungen
Browser-Kompatibilität
Loading…
Hinweis:
Diese API basiert auf der chrome.downloads API von Chromium.