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
integerreprésentant l'iddudownloads.DownloadItemque 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
Chargement…
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);
Exemples d'extensions
Note :
Cette API est basée sur l'API Chromium chrome.downloads.