downloads.show()

show()函数的downloadsAPI 在底层平台的文件管理器中显示包含文件夹中的已下载文件。

这是一个返回Promise的异步函数。

语法

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

参数

downloadId

一个integer表示要显示的DownloadItem的 ID。

返回值

一个Promise。如果请求成功,则 promise 将以关于请求是否成功的布尔值来完成。如果请求失败,则 promise 将被拒绝并显示错误消息。

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

示例

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

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.downloadsAPI。