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
Chrome | Edge | Firefox | Firefox for Android | Opera | |
---|---|---|---|---|---|
Alarm | Yes | No | 45 | 48 | Yes |
clear | Yes | No | 45 | 48 | Yes |
clearAll | Yes | No | 45 | 48 | Yes |
create | Yes | No | 45 | 48 | Yes |
get | Yes | No | 45 | 48 | Yes |
getAll | Yes | No | 45 | 48 | Yes |
onAlarm | Yes | No | 45 | 48 | 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.