alarms.onAlarm

当扩展程序设置的任何警报到期时触发。

语法

js
browser.alarms.onAlarm.addListener(listener)
browser.alarms.onAlarm.removeListener(listener)
browser.alarms.onAlarm.hasListener(listener)

事件有三个函数

addListener(listener)

向此事件添加监听器。

removeListener(listener)

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

hasListener(listener)

检查 listener 是否已为此事件注册。如果正在监听,则返回 true,否则返回 false

addListener 语法

参数

监听器

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

alarm

alarms.Alarm。到期的警报。使用 Alarm.name 来确定哪个警报到期了。

示例

处理警报到期

js
function handleAlarm(alarmInfo) {
  console.log(`on alarm: ${alarmInfo.name}`);
}

browser.alarms.onAlarm.addListener(handleAlarm);

扩展程序示例

浏览器兼容性

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