downloads.show()

downloads API 的 show() 函数会在底层平台的文件夹管理器中显示已下载的文件所在的文件夹。

这是一个异步函数,返回一个 Promise

语法

js
let showing = browser.downloads.show(
  downloadId             // integer
)

参数

downloadId

一个表示要显示的 DownloadItem ID 的整数

返回值

一个 Promise。如果请求成功,Promise 将会以一个布尔值(表示请求是否成功)来 fulfilled。如果请求失败,Promise 将会以一个错误消息来 rejected。

示例

此示例显示了最近下载的项目

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);

浏览器兼容性

注意:此 API 基于 Chromium 的 chrome.downloads API。