Cancels an alarm, given its name.

This is an asynchronous function that returns a Promise.


var clearAlarm = browser.alarms.clear(
  name                       // string


string. The name of the alarm to clear. If you don't supply this, the empty string "" will be used.

Return value

A Promise that will be fulfilled with a boolean. This will be true if the alarm was cleared, false otherwise.

Browser compatibility

ChromeEdgeFirefoxFirefox for AndroidOpera
Basic support Yes No4548 Yes


function onCleared(wasCleared) {
  console.log(wasCleared);  // true/false

var clearAlarm = browser.alarms.clear("my-periodic-alarm");


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: wbamberg, Makyen
Last updated by: wbamberg,