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 |
The "Chrome incompatibilities" section is included from https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities using the WebExtChromeCompat macro.
If you need to update this content, edit https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities, then shift-refresh this page to see your changes.
Chrome incompatibilities
None.
Example extensions
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.