downloads.onCreated

downloads API 的 onCreated() 事件在下載開始時觸發,也就是說,當 downloads.download() 成功呼叫時觸發。

監聽器會收到相關的 downloads.DownloadItem 物件作為引數。

語法

js
browser.downloads.onCreated.addListener(listener)
browser.downloads.onCreated.removeListener(listener)
browser.downloads.onCreated.hasListener(listener)

事件有三個函式

addListener(listener)

向此事件新增監聽器。

removeListener(listener)

停止監聽此事件。listener 引數是要移除的監聽器。

hasListener(listener)

檢查給定的 listener 是否已註冊此事件。如果正在監聽,則返回 true,否則返回 false

addListener 語法

引數

function

發生此事件時呼叫的函式。此函式會收到以下引數:

downloadItem

相關的 downloads.DownloadItem 物件。

示例

在下載項時記錄它們的 URL

js
function handleCreated(item) {
  console.log(item.url);
}

browser.downloads.onCreated.addListener(handleCreated);

瀏覽器相容性

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