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。