downloads.show()

The show() function of the downloads API shows the downloaded file in its containing folder in the underlying platform's file manager.

Syntax

chrome.downloads.show(
  downloadId,             // integer
  function(success) {...} // optional callback function
)

This API is also available as browser.downloads.show() in a version that returns a promise.

Parameters

downloadId
An integer representing the ID of the DownloadItem to show.
callbackOptional
An optional callback function that gets invoked when the open() call has completed. It is passed the following arguments:
success
A boolean that defines whether the show() call was successful (true), or not (false).

Browser compatibility

Chrome Edge Firefox Firefox for Android Opera
Basic support Yes No 48.0 48.0 33

Examples

The following snippet shows two buttons, "download" and "show". The first button when clicked initiates a download via downloads.download(). Once the download has started, the second button can be pressed to show the file in the file manager:

var downloadBtn = document.querySelector('.download');
var showBtn = document.querySelector('.show');

downloadBtn.onclick = function() {
  chrome.downloads.download({ url : 'http://www.example.com/myBigVideo.mp4'},
  callback);

  function callback(downloadId) {
    if(chrome.runtime.lastError) {
      console.log(chrome.runtime.lastError);
    } else {
      showBtn.onclick = function() {
        chrome.downloads.show(downloadId, function(success) {
          if(success) {
            console.log('File shown in explorer');
          }
        });
      }
    }
  }
}

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.

Document Tags and Contributors

 Contributors to this page: Makyen, wbamberg, chrisdavidmills
 Last updated by: Makyen,