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
Alarm (Yes) No4548 (Yes)
clear (Yes) No4548 (Yes)
clearAll (Yes) No4548 (Yes)
create (Yes) No4548 (Yes)
get (Yes) No4548 (Yes)
getAll (Yes) No4548 (Yes)
onAlarm (Yes) No4548 (Yes)

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,