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。