alarms

Schedule code to run at a specific time in the future. This is like setTimeout() and setInterval(), except that those functions don't work with background pages that are loaded on demand.

To use this API you need to have the "alarms" permission.

Types

alarms.Alarm
Information about a particular alarm.

Functions

alarms.create()
Create a new alarm.
alarms.get()
Retrieves a specific alarm, given its name.
alarms.getAll()
Retrieve all scheduled alarms.
alarms.clear()
Clear a specific alarm, given its name.
alarms.clearAll()
Clear all scheduled alarms.

Events

alarms.onAlarm
Fired when an alarm goes off.

Browser compatibility

ChromeEdgeFirefoxFirefox for AndroidOpera
AlarmYesNo4548Yes
clearYesNo4548Yes
clearAllYesNo4548Yes
createYesNo4548Yes
getYesNo4548Yes
getAllYesNo4548Yes
onAlarmYesNo4548Yes

Chrome incompatibilities

None.

Example extensions

Acknowledgements

This API is based on Chromium's chrome.alarms API.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

Document Tags and Contributors

 Contributors to this page: wbamberg, evilpie
 Last updated by: wbamberg,