downloads.open()

La fonction open() de l'API downloads ouvre le fichier téléchargé avec son application associée. Un événement downloads.onChanged se déclenche lorsque l'élément est ouvert pour la première fois.

Pour utiliser cette fonction dans votre extension, vous devez demander la permission manifest "downloads.open", ainsi que la permission "downloads". En outre, vous pouvez uniquement appeler cette fonction à l'intérieur du gestionnaire pour une action utilisateur.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

js
var opening = browser.downloads.open(
  downloadId, // integer
);

Paramètres

downloadId

Un integer représentant l'id du downloads.DownloadItem que vous voulez ouvrir.

Valeur retournée

Une Promise. Si la demande a été acceptée, la promesse sera remplie sans arguments. Si la demande a échoué, la promesse sera rejetée avec un message d'erreur.

Compatibilité des navigateurs

Exemples

Cet exemple ouvre l'élément le plus récemment téléchargé :

js
function onOpened() {
  console.log(`Opened download item`);
}

function onError(error) {
  console.log(`Error opening item: ${error}`);
}

function openDownload(downloadItems) {
  if (downloadItems.length > 0) {
    var opening = browser.downloads.open(downloadItems[0].id);
    opening.then(onOpened, onError);
  }
}

var searching = browser.downloads.search({
  limit: 1,
  orderBy: ["-startTime"],
});

searching.then(openDownload, onError);

Example extensions

Note :

Cette API est basée sur l'API Chromium chrome.downloads.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.