downloads.onCreated

当下载开始时,即成功调用downloads.download()时,downloads API 的onCreated()事件将触发。

侦听器将被传递正在讨论的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 语法

参数

函数

当此事件发生时调用的函数。此函数将传递此参数

downloadItem

正在讨论的downloads.DownloadItem对象。

浏览器兼容性

BCD 表格仅在浏览器中加载

示例

记录下载项目的 URL

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

browser.downloads.onCreated.addListener(handleCreated);

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