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. Alarms do not persist across browser sessions.
To use this API you need to have the "alarms" permission.
Types
alarms.Alarm- Information about a particular alarm.
Methods
alarms.clear()- Clear a specific alarm, given its name.
alarms.clearAll()- Clear all scheduled alarms.
alarms.create()- Create a new alarm.
alarms.get()- Retrieves a specific alarm, given its name.
alarms.getAll()- Retrieve all scheduled alarms.
Events
alarms.onAlarm- Fired when an alarm goes off.
Example extensions
Browser compatibility
Update compatibility data on GitHub
| Desktop | Mobile | ||||
|---|---|---|---|---|---|
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
- See implementation notes.
- See implementation notes.
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.