downloads.open()

Die Funktion open() der downloads API öffnet die heruntergeladene Datei mit der zugeordneten 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-Erlaubnis sowie die "downloads"-Erlaubnis 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

js
let opening = browser.downloads.open(
  downloadId      // integer
)

Parameter

downloadId

Ein integer, der die id des downloads.DownloadItem darstellt, das Sie öffnen möchten.

Rückgabewert

Ein Promise. Wenn die Anfrage erfolgreich ist, wird das Promise ohne Argumente erfüllt. Wenn die Anfrage fehlschlägt, wird das Promise mit einer Fehlermeldung abgelehnt.

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
open

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Beispiele

Dieses Beispiel öffnet das zuletzt heruntergeladene Element:

js
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

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