Modules

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, telle que

  • en cliquant sur l'action du navigateur de l'extension ou sur l'action de la page
  • sélectionner son élément de menu contextuel
  • l'activation d'un raccourci clavier défini par l'extension (remarque : ceci n'est actuellement pas supporté dans Firefox)
  • en cliquant sur un bouton dans une page associée à l'extension.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

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é du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple Oui Non4848 Oui

Exemples

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

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

Remerciements :

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.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,