downloads.show()
The show()
function of the downloads
API shows the downloaded file in its containing folder in the underlying platform's file manager.
This is an asynchronous function that returns a Promise
.
Syntax
js
let showing = browser.downloads.show(
downloadId // integer
)
Parameters
downloadId
-
An
integer
representing the ID of theDownloadItem
to show.
Return value
A Promise
. If the request succeeds, the promise will be fulfilled with a boolean about whether the request was successful. If the request fails, the promise will be rejected with an error message.
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | ||||||
---|---|---|---|---|---|---|---|
show |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Examples
This example shows the most recently downloaded item:
js
function onShowing(success) {
console.log(`Showing download item: ${success}`);
}
function onError(error) {
console.log(`Error opening item: ${error}`);
}
function openDownload(downloadItems) {
if (downloadItems.length > 0) {
latestDownloadId = downloadItems[0].id;
let showing = browser.downloads.show(latestDownloadId);
showing.then(onShowing, onError);
}
}
let searching = browser.downloads.search({
limit: 1,
orderBy: ["-startTime"],
});
searching.then(openDownload, onError);
Note:
This API is based on Chromium's chrome.downloads
API.