---
title: alarms
slug: Mozilla/Add-ons/WebExtensions/API/alarms
tags:
  - API
  - Besoins Privilèges
  - Extensions
  - Interface
  - Reference
  - WebExtensions
  - alarms
translation_of: Mozilla/Add-ons/WebExtensions/API/alarms
---
<div>{{AddonSidebar}}</div>

<p>Programmer le code pour qu'il soit exécuté à un moment précis dans le futur. C'est comme <code><a href="/fr/docs/Web/API/WindowTimers/setTimeout">setTimeout()</a></code> and <code><a href="/fr/docs/Web/API/WindowTimers/setInterval">setInterval()</a></code> sauf que ces fonctions ne fonctionnent pas avec les pages d'arrière-plan qui sont chargées à la demande. Les alarmes ne persistent pas d'une session à l'autre du navigateur</p>

<p>Pour pouvoir utiliser cette API, vous devez disposer de la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> <code>"alarms"</code>.</p>

<h2 id="Types">Types</h2>

<dl>
 <dt>{{WebExtAPIRef("alarms.Alarm")}}</dt>
 <dd>Ce type permet d'obtenir des informations à propos d'une alarme donnée.</dd>
</dl>

<h2 id="Méthodes">Méthodes</h2>

<dl>
 <dt>{{WebExtAPIRef("alarms.create()")}}</dt>
 <dd>Cette fonction permet de créer une nouvelle alarme.</dd>
 <dt>{{WebExtAPIRef("alarms.get()")}}</dt>
 <dd>Cette fonction permet de récupérer une alarme donnée en fonction de son nom.</dd>
 <dt>{{WebExtAPIRef("alarms.getAll()")}}</dt>
 <dd>Cette fonction permet de récupérer l'ensemble des alarmes qui sont planifiées.</dd>
 <dt>{{WebExtAPIRef("alarms.clear()")}}</dt>
 <dd>Cette fonction permet de supprimer une alarme donnée en fonction de son nom.</dd>
 <dt>{{WebExtAPIRef("alarms.clearAll()")}}</dt>
 <dd>Cette fonction permet de supprimer l'ensemble des alarmes qui sont planifiées.</dd>
</dl>

<h2 id="Évènements">Évènements</h2>

<dl>
 <dt>{{WebExtAPIRef("alarms.onAlarm")}}</dt>
 <dd>Cet évènement est déclenché lorsque l'alarme s'éteint.</dd>
</dl>

<p>{{WebExtExamples("h2")}}</p>

<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>

<p>{{Compat("webextensions.api.alarms")}}</p>

<div class="note"><p><strong>Note :</strong></p>

<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/alarms"><code>chrome.alarms</code></a>.</p>

<p>Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.</p>
</div>