downloads.open()
Die open() Funktion der downloads API öffnet die heruntergeladene Datei mit der zugehörigen Anwendung. Ein downloads.onChanged Ereignis wird ausgelöst, wenn das Element zum ersten Mal geöffnet wird.
Um diese Funktion in Ihrer Erweiterung zu verwenden, müssen Sie die "downloads.open" Manifest-Berechtigung sowie die "downloads"-Berechtigung anfordern. Außerdem können Sie diese Funktion nur innerhalb des Handlers für eine Benutzeraktion aufrufen.
Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.
Syntax
let opening = browser.downloads.open(
downloadId // integer
)
Parameter
downloadId-
Ein
integer, der dieiddesdownloads.DownloadItemangibt, das Sie öffnen möchten.
Rückgabewert
Ein Promise. Wenn die Anfrage erfolgreich ist, wird das Promise ohne Argumente erfüllt. Wenn die Anfrage fehlgeschlagen ist, wird das Promise mit einer Fehlermeldung abgelehnt.
Beispiele
Dieses Beispiel öffnet das zuletzt heruntergeladene Element:
function onOpened() {
console.log(`Opened download item`);
}
function onError(error) {
console.log(`Error opening item: ${error}`);
}
function openDownload(downloadItems) {
if (downloadItems.length > 0) {
let opening = browser.downloads.open(downloadItems[0].id);
opening.then(onOpened, onError);
}
}
let searching = browser.downloads.search({
limit: 1,
orderBy: ["-startTime"],
});
searching.then(openDownload, onError);
Beispielerweiterungen
Browser-Kompatibilität
Loading…
Hinweis:
Diese API basiert auf der Chromium chrome.downloads API.