downloads.removeFile()
Die removeFile() Funktion der downloads API entfernt eine heruntergeladene Datei von der Festplatte.
Diese API entfernt die Datei von der Festplatte, jedoch nicht aus dem Download-Verlauf des Browsers. Ein Aufruf von downloads.search() wird das Element weiterhin als DownloadItem zurückgeben, aber dessen exists Attribut 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 in umgekehrter Reihenfolge versuchen, tritt ein Fehler auf, wenn removeFile() aufgerufen wird, da der Browser keinen Eintrag mehr für den Download hat.
Syntax
let removing = browser.downloads.removeFile(
downloadId // integer
)
Parameter
downloadId-
Eine
integer, die die ID desDownloadItemdarstellt, 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 fehlschlug, wird das Promise mit einer Fehlermeldung abgelehnt.
Beispiele
Entfernen Sie die zuletzt heruntergeladene Datei:
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
Loading…
Hinweis:
Diese API basiert auf der chrome.downloads API von Chromium.