runtime.onUpdateAvailable
当扩展程序有可用更新时触发。此事件允许扩展程序延迟更新:例如,因为它正处于不应中断的某个操作的中间。
如果扩展程序在有可用更新时未监听此事件,则扩展程序会立即重新加载并应用更新。如果扩展程序正在监听,则在下次重新加载扩展程序时将应用更新。这发生在以下情况:
- 浏览器重启
- 扩展程序被禁用然后重新启用
- 扩展程序通过调用
runtime.reload()
显式重新加载自身。
语法
js
browser.runtime.onUpdateAvailable.addListener()
browser.runtime.onUpdateAvailable.removeListener(listener)
browser.runtime.onUpdateAvailable.hasListener(listener)
事件有三个函数
addListener(listener)
-
向此事件添加监听器。
removeListener(listener)
-
停止监听此事件。
listener
参数是要移除的监听器。 hasListener(listener)
-
检查此事件是否已注册
listener
。如果正在侦听,则返回true
,否则返回false
。
addListener 语法
参数
示例
监听 UpdateAvailable
事件
js
function handleUpdateAvailable(details) {
console.log(details.version);
// Proceed to upgrade the add-on
browser.runtime.reload();
}
browser.runtime.onUpdateAvailable.addListener(handleUpdateAvailable);
浏览器兼容性
加载中…
注意:此 API 基于 Chromium 的 chrome.runtime
API。本文档来源于 Chromium 代码中的 runtime.json
。