downloads.onChanged

语法

browser.downloads.onChanged.addListener(listener)
browser.downloads.onChanged.removeListener(listener)
browser.downloads.onChanged.hasListener(listener)

事件有三个函数

addListener(listener)

向此事件添加监听器。

removeListener(listener)

停止监听此事件。listener 参数是要移除的监听器。

hasListener(listener)

检查给定的 listener 是否已注册此事件。如果正在监听，则返回 true，否则返回 false。

addListener 语法

参数

监听器

发生此事件时调用的函数。此函数将接收以下参数：

downloadDelta

一个 object，表示已更改的 downloads.DownloadItem 对象，以及其中已更改的所有属性的状态。有关更多详细信息，请参阅 downloadDelta 部分。

额外对象

downloadDelta

downloadDelta 对象具有以下可用属性：

id

一个 integer，表示已更改的 downloads.DownloadItem 的 id。

url 可选

一个 downloads.StringDelta 对象，描述了 downloads.DownloadItem 的 url 的更改。

filename 可选

一个 downloads.StringDelta 对象，描述了 downloads.DownloadItem 的 filename 的更改。

danger 可选

一个 downloads.StringDelta 对象，描述了 downloads.DownloadItem 的 danger 的更改。

mime 可选

一个 downloads.StringDelta 对象，描述了 downloads.DownloadItem 的 mime 的更改。

startTime 可选

一个 downloads.StringDelta 对象，描述了 downloads.DownloadItem 的 startTime 的更改。

endTime 可选

一个 downloads.StringDelta 对象，描述了 downloads.DownloadItem 的 endTime 的更改。

state 可选

一个 downloads.StringDelta 对象，描述了 downloads.DownloadItem 的 state 的更改。

canResume 可选

一个 downloads.BooleanDelta 对象，描述了 downloads.DownloadItem 的 canResume 状态的更改。

paused 可选

一个 downloads.BooleanDelta 对象，描述了 downloads.DownloadItem 的 paused 状态的更改。

error 可选

一个 downloads.StringDelta 对象，描述了 downloads.DownloadItem 的 error 状态的更改。

totalBytes 可选

一个 downloads.DoubleDelta 对象，描述了 downloads.DownloadItem 的 totalBytes 的更改。

fileSize 可选

一个 downloads.DoubleDelta 对象，描述了 downloads.DownloadItem 的 fileSize 的更改。

exists 可选

一个 downloads.BooleanDelta 对象，描述了 downloads.DownloadItem 的 exists 状态的更改。

示例

下载完成时记录一条消息

function handleChanged(delta) {
  if (delta.state && delta.state.current === "complete") {
    console.log(`Download ${delta.id} has completed.`);
  }
}

browser.downloads.onChanged.addListener(handleChanged);

浏览器兼容性