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

BCD tables only load in the browser

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);

Beispiel-Erweiterungen

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