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
var 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 GitHubwebextensions-desktop | webextensions-mobile | |||||
---|---|---|---|---|---|---|
show | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support48 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo support48 — 79 |
Legend
- 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:
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;
var showing = browser.downloads.show(latestDownloadId);
showing.then(onShowing, onError);
}
}
var searching = browser.downloads.search({
limit: 1,
orderBy: ["-startTime"]
});
searching.then(openDownload, onError);
Acknowledgements
This API is based on Chromium's chrome.downloads
API.
Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.