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.

Methods

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
DesktopMobile
ChromeEdgeFirefoxOperaFirefox for Android
AlarmChrome Full support YesEdge No support NoFirefox Full support 45Opera Full support YesFirefox Android Full support 48
clearChrome Full support YesEdge No support NoFirefox Full support 45Opera Full support YesFirefox Android Full support 48
clearAllChrome Full support YesEdge No support NoFirefox Full support 45Opera Full support YesFirefox Android Full support 48
createChrome Full support YesEdge No support NoFirefox Full support 45Opera Full support YesFirefox Android Full support 48
getChrome Full support YesEdge No support NoFirefox Full support 45Opera Full support YesFirefox Android Full support 48
getAllChrome Full support YesEdge No support NoFirefox Full support 45Opera Full support YesFirefox Android Full support 48
onAlarmChrome Full support YesEdge No support NoFirefox Full support 45Opera Full support YesFirefox 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.

Document Tags and Contributors

Contributors to this page: irenesmith, fscholz, wbamberg, ExE-Boss, evilpie
Last updated by: irenesmith,