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
Update compatibility data on GitHub
| Desktop | Mobile | ||||
|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Firefox for Android | |
Alarm | Chrome Full support Yes | Edge No support No | Firefox Full support 45 | Opera Full support Yes | Firefox Android Full support 48 |
clear | Chrome Full support Yes | Edge No support No | Firefox Full support 45 | Opera Full support Yes | Firefox Android Full support 48 |
clearAll | Chrome Full support Yes | Edge No support No | Firefox Full support 45 | Opera Full support Yes | Firefox Android Full support 48 |
create | Chrome Full support Yes | Edge No support No | Firefox Full support 45 | Opera Full support Yes | Firefox Android Full support 48 |
get | Chrome Full support Yes | Edge No support No | Firefox Full support 45 | Opera Full support Yes | Firefox Android Full support 48 |
getAll | Chrome Full support Yes | Edge No support No | Firefox Full support 45 | Opera Full support Yes | Firefox Android Full support 48 |
onAlarm | Chrome Full support Yes | Edge No support No | Firefox Full support 45 | Opera Full support Yes | Firefox Android Full support 48 |
Legend
- Full support
- Full support
- No support
- No support
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.