chrome.alarms

创建定时器，在 alarmInfo 指定的时间前后将产生 onAlarm 事件。如果已经存在具有相同名称（或者如果没指定而没有名称）另一个定时器，它将会被取消，并由这一定时器取代。

为了降低用户计算机的资源占用，Chrome 浏览器将定时器限制为最多每 1 分钟一次，而且可能会推迟任意长度的时间。也就是说，将 delayInMinutes 或 periodInMinutes 设置为小于 1 的值不会被认可，并会导致警告，when 可以设置为当前时间后小于1分钟的值，但是定时器至少在 1 分钟内不会运行。

为了帮助您调试您的应用或扩展程序，当您以未打包的形式加载时，不会限制定时器产生的频率。

参数

name ( optional string )

标识该定时器的可选字符串，默认为空字符串。

alarmInfo ( object )

描述定时器触发的时刻，初始时刻必须由 when 或者 delayInMinutes 中的某一个（但不能同时）指定。如果设置了 periodInMinutes，定时器将在初始事件后每隔 periodInMinutes 分钟重复。如果重复定时器的 when 或 delayInMinutes 都没有设置，periodInMinutes 将作为 delayInMinutes 的默认值。

属性

when ( optional double )

定时器应该触发的时刻，以纪元以来所经过的毫秒数为单位（例如 Date.now() + n）。

delayInMinutes ( optional double )

以分钟为单位的时间长度，在指定时间之后将产生 onAlarm 事件。

periodInMinutes ( optional double )

如果设置了该属性，定时器将在由 when 或者 delayInMinutes 指定的初始时间后每隔 periodInMinutes 分钟触发。如果没有设置，定时器只会触发一次。

获取指定定时器的有关详情。

参数

name ( optional string )

要获取的定时器名称，默认为空字符串。

callback ( function )

callback 参数应该指定一个如下形式的函数：

function(Alarm alarm) {...};

alarm ( Alarm )

获取包含所有定时器的数组。

参数

callback ( function )

callback 参数应该指定一个如下形式的函数：

function(array of Alarm alarms) {...};

alarms ( array of Alarm )

清除指定名称的定时器。

参数

name ( optional string )

要清除的定时器名称，默认为空字符串。

清除所有定时器。

当定时器到达时间时产生，对于事件页面很有用。

function(Alarm alarm) {...};