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
var opening = browser.downloads.open(
downloadId, // integer
);
Paramètres
downloadId
-
Un
integer
représentant l'id
dudownloads.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
BCD tables only load in the browser
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
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.