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。