initial commit

8 files changed, 545 insertions, 0 deletions

diff --git a/files/fr/mozilla/add-ons/webextensions/api/alarms/alarm/index.html b/files/fr/mozilla/add-ons/webextensions/api/alarms/alarm/index.html
new file mode 100644
index 0000000000..a5500ca765
--- /dev/null
+++ b/files/fr/mozilla/add-ons/webextensions/api/alarms/alarm/index.html
@@ -0,0 +1,46 @@
+---
+title: alarms.Alarm
+slug: Mozilla/Add-ons/WebExtensions/API/alarms/Alarm
+tags:
+  - API
+  - Add-ons
+  - Extensions
+  - Non-standard
+  - Reference
+  - Type
+  - WebExtensions
+  - alarm
+  - alarms
+translation_of: Mozilla/Add-ons/WebExtensions/API/alarms/Alarm
+---
+<div>{{AddonSidebar}}</div>
+
+<p>Cette interface fournit des informations sur une alarme donnée. Cet objet est retourné à partir de {{WebExtAPIRef('alarms.get()')}} et {{WebExtAPIRef('alarms.getAll()')}} et est passé au gestionnaire d'évènement {{WebExtAPIRef('alarms.onAlarm')}}.</p>
+
+<h2 id="Type">Type</h2>
+
+<p>Les valeurs de ce type sont des objets contenant les propriétés suivantes :</p>
+
+<dl class="reference-values">
+ <dt><code>name</code></dt>
+ <dd><code>string</code> Une chaîne de caractères contenant le nom de l'alarme. Ce nom provient de celui qui a été fourni à la méthode {{WebExtAPIRef('alarms.create()')}} lors de la création de l'alarme.</dd>
+ <dt><code>scheduledTime</code></dt>
+ <dd><code>double</code> Un nombre qui représente l'heure à laquelle l'alarme doit être déclenchée, exprimée <a href="https://fr.wikipedia.org/wiki/Heure_Unix">en nombre de millisecondes depuis epoch</a>.</dd>
+ <dt><code>periodInMinutes</code>{{optional_inline}}</dt>
+ <dd><code>double</code> Un nombre qui, s'il n'est pas <code>null</code>, indique que l'alarme est périodique et fournit la période.</dd>
+</dl>
+
+<h2 id="Compatibilité_des_navigateur">Compatibilité des navigateur</h2>
+
+<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p>
+
+<p>{{Compat("webextensions.api.alarms.Alarm")}}</p>
+
+<p>{{WebExtExamples}}</p>
+
+<div class="note">&lt;<strong>Remerciements :</strong>
+
+<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>
diff --git a/files/fr/mozilla/add-ons/webextensions/api/alarms/clear/index.html b/files/fr/mozilla/add-ons/webextensions/api/alarms/clear/index.html
new file mode 100644
index 0000000000..505237ce9d
--- /dev/null
+++ b/files/fr/mozilla/add-ons/webextensions/api/alarms/clear/index.html
@@ -0,0 +1,64 @@
+---
+title: alarms.clear()
+slug: Mozilla/Add-ons/WebExtensions/API/alarms/clear
+tags:
+  - API
+  - Add-ons
+  - Extensions
+  - Méthode
+  - Non-standard
+  - Reference
+  - WebExtensions
+  - alarms
+  - clear
+translation_of: Mozilla/Add-ons/WebExtensions/API/alarms/clear
+---
+<div>{{AddonSidebar}}</div>
+
+<p>Cette méthode supprime une alarme à partir du nom passé en argument. Il s'agit d'une fonction asynchrone qui renvoie une {{jsxref("Promise")}}.</p>
+
+<h2 id="Syntaxe">Syntaxe</h2>
+
+<pre class="syntaxbox">var clearAlarm = browser.alarms.clear(
+  name // string
+);
+</pre>
+
+<h3 id="Paramètres">Paramètres</h3>
+
+<dl>
+ <dt><code>name</code>{{optional_inline}}</dt>
+ <dd><code><code>string</code></code>. Le nom de l'alarme à supprimer. Si le paramètre n'est pas fourni, c'est la chaîne vide "" qui sera utilisée.</dd>
+</dl>
+
+<h3 id="Valeur_de_retour">Valeur de retour</h3>
+
+<p>Une promesse ({{jsxref("Promise")}}) qui sera tenue avec un booléen. Ce booléen vaudra <code>true</code> si l'alarme a bien été effacée et <code>false</code> sinon.</p>
+
+<h2 id="Exemples">Exemples</h2>
+
+<pre class="brush: js">function onCleared(wasCleared) {
+  console.log(wasCleared);  // true/false
+}
+
+var clearAlarm = browser.alarms.clear("my-periodic-alarm");
+clearAlarm.then(onCleared);</pre>
+
+<p>{{WebExtExamples}}</p>
+
+<p> </p>
+
+<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
+
+<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p>
+
+<p>{{Compat("webextensions.api.alarms.clear")}}</p>
+
+<p> </p>
+
+<div class="note">&lt;<strong>Remerciements :</strong>
+
+<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>
diff --git a/files/fr/mozilla/add-ons/webextensions/api/alarms/clearall/index.html b/files/fr/mozilla/add-ons/webextensions/api/alarms/clearall/index.html
new file mode 100644
index 0000000000..f183256ffb
--- /dev/null
+++ b/files/fr/mozilla/add-ons/webextensions/api/alarms/clearall/index.html
@@ -0,0 +1,57 @@
+---
+title: alarms.clearAll()
+slug: Mozilla/Add-ons/WebExtensions/API/alarms/clearAll
+tags:
+  - API
+  - Add-ons
+  - Extensions
+  - Méthode
+  - Non-standard
+  - Reference
+  - WebExtensions
+  - alarms
+  - clearAll
+translation_of: Mozilla/Add-ons/WebExtensions/API/alarms/clearAll
+---
+<div>{{AddonSidebar}}</div>
+
+<p>Cette méthode supprime toutes les alarmes actives. C'est une fonction asynchrone qui renvoie une promesse {{jsxref("Promise")}}.</p>
+
+<h2 id="Syntaxe">Syntaxe</h2>
+
+<pre class="syntaxbox brush:js">var clearAlarms = browser.alarms.clearAll()
+</pre>
+
+<h3 id="Paramètres">Paramètres</h3>
+
+<p>Aucun.</p>
+
+<h3 id="Valeur_de_retour">Valeur de retour</h3>
+
+<p>Une promesse ({{jsxref("Promise")}}) qui sera tenue avec une valeur booléenne. Ce dernier vaudra <code>true</code> si certaines alarmes ont bien été effacées et <code>false</code> sinon. On notera que Chrome renvoie toujours <code>true</code>.</p>
+
+<h2 id="Exemples">Exemples</h2>
+
+<pre class="brush: js">function onClearedAll(wasCleared) {
+  console.log(wasCleared);  // true/false
+}
+
+var clearAlarms = browser.alarms.clearAll();
+clearAlarms.then(onClearedAll);</pre>
+
+<p>{{WebExtExamples}}</p>
+
+<p> </p>
+
+<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
+
+<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p>
+
+<p>{{Compat("webextensions.api.alarms.clearAll")}}</p>
+
+<div class="note"><strong>Remerciements :</strong>
+
+<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>
diff --git a/files/fr/mozilla/add-ons/webextensions/api/alarms/create/index.html b/files/fr/mozilla/add-ons/webextensions/api/alarms/create/index.html
new file mode 100644
index 0000000000..97b8a189af
--- /dev/null
+++ b/files/fr/mozilla/add-ons/webextensions/api/alarms/create/index.html
@@ -0,0 +1,105 @@
+---
+title: alarms.create()
+slug: Mozilla/Add-ons/WebExtensions/API/alarms/create
+tags:
+  - API
+  - Add-ons
+  - Créations
+  - Extensions
+  - Méthode
+  - Non-standard
+  - Reference
+  - WebExtensions
+  - alarms
+translation_of: Mozilla/Add-ons/WebExtensions/API/alarms/create
+---
+<div>{{AddonSidebar()}}</div>
+
+<p>Cette méthode permet de créer une nouvelle alarme pour la session de navigation en cours. Une alarme peut se déclencher une ou plusieurs fois. Une alarme est effacée après qu'elle se soit déclenchée pour la dernière fois.</p>
+
+<h2 id="Syntaxe">Syntaxe</h2>
+
+<pre class="brush: js">browser.alarms.create(
+  name,        // une valeur string optionnelle
+  alarmInfo    // une valeur object optionnelle
+)
+</pre>
+
+<h3 id="Paramètres">Paramètres</h3>
+
+<dl>
+ <dt><code>name</code>{{optional_inline}}</dt>
+ <dd><code>string</code>. Le nom utilisé pour l'alarme. Par défaut, la chaîne utilisée sera la chaîne vide.</dd>
+ <dd>Cette valeur pourra être utilisée pour indiquer une alarme donnée avec les méthodes {{WebExtAPIRef('alarms.get()')}} et {{WebExtAPIRef('alarms.clear()')}}. Il sera également disponible pour {{WebExtAPIRef('alarms.onAlarm')}} sous la forme de la propriété <code>name</code> de l'objet {{WebExtAPIRef('alarms.Alarm')}} passé au gestionnaire d'évènement.</dd>
+ <dd>Pour une extension donnée, les noms d'alarmes sont toujours uniques (dans le cadre d'une seule extension). Si le nom donné ici correspond à une alarme existante pour cette extension, l'alarme existante sera supprimée et ne se déclenchera pas.</dd>
+ <dt><code>alarmInfo</code>{{optional_inline}}</dt>
+ <dd>
+ <p><code>object</code>. Un objet de configuration qui indique le moment du premier déclenchement comme valeur absolue (<code>when</code>) ou relative (<code>delayInMinutes</code>). Pour que l'alarme se repète, on utilisera le champ <code>periodInMinutes</code>.</p>
+
+ <p>Sur Chrome, à moins que l'extension ne soit chargée, les alarmes créées ne sont pas autorisées à se déclencher plus d'une fois par minute. Si une extension tente de définir <code>delayInMinutes</code> avec une valeur strictement inférieure à 1 ou avec une valeur strictement inférieure à 1 dans le futur, l'alarme se déclenchera 1 minute après ce délai. Si une extension essaie de définir <code>periodInMinutes</code> avec une valeur strictement inférieure à 1, l'alarme se déclenchera alors chaque minute.</p>
+
+ <p>L'objet <code>alarmInfo</code> peut contenir les propriétés suivantes :</p>
+ </dd>
+ <dd>
+ <dl class="reference-values">
+  <dt><code>when</code>{{optional_inline}}</dt>
+  <dd><code>double</code>. Le moment où l'alarme se déclenchera en premier. L'instant est indiquée comme une valeur absolue, exprimée en <a href="https://fr.wikipedia.org/wiki/Heure_Unix">millisecondes depuis epoch</a>. Pour obtenir le nombre de millisecondes entre l'époque et l'heure actuelle, on pourra utiliser {{jsxref("Date.now")}}. Si cette valeur est utilisée, il ne faut pas fournir <code>delayInMinutes</code>.</dd>
+  <dt><code>delayInMinutes</code>{{optional_inline}}</dt>
+  <dd><code>double</code>. Le moment où l'alarme se déclenchera en premier exprimée de façon relative au moment où l'alarme est créée. Si cette option est utilisée, il ne faut pas fournir <code>when</code>.</dd>
+  <dt><code>periodInMinutes</code>{{optional_inline}}</dt>
+  <dd><code>double</code>. Si cette valeur est indiquée, l'alarme sera répétée périodiquement (toutes les <code>periodInMinutes</code> minutes) après le premier déclenchement. Si cette valeur est indiquée, il n'est pas obligatoire de fournir <code>when</code> ou <code>delayInMinutes</code> : l'alarme se déclenchera au bout de <code>periodInMinutes</code>. Si <code>periodInMinutes</code> n'est pas indiquée, l'alarme ne se déclenchera qu'une seule fois.</dd>
+ </dl>
+ </dd>
+</dl>
+
+<h2 id="Exemples">Exemples</h2>
+
+<h3 id="Alarme_vide">Alarme vide</h3>
+
+<pre class="brush: js">const delayInMinutes = 5;
+
+<span class="pl-smi">browser</span>.<span class="pl-smi">alarms</span>.<span class="pl-en">create</span>({
+  delayInMinutes
+});</pre>
+
+<h3 id="Alarme_relative_périodique">Alarme relative périodique</h3>
+
+<pre class="brush: js">const delayInMinutes = 5;
+const periodInMinutes = 2;
+
+browser.alarms.create("my-periodic-alarm", {
+  delayInMinutes,
+  periodInMinutes
+});</pre>
+
+<h3 id="Alarme_périodique_absolue">Alarme périodique absolue</h3>
+
+<pre class="brush: js">const when = 1545696000;
+const periodInMinutes = 2;
+
+browser.alarms.create("my-periodic-alarm", {
+  when,
+  periodInMinutes
+});</pre>
+
+<dl>
+ <dd>
+ <dl class="reference-values">
+ </dl>
+ </dd>
+</dl>
+
+<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2>
+
+<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p>
+
+<p>{{Compat("webextensions.api.alarms.create")}}</p>
+
+
+
+<div class="note"><strong>Remerciements :</strong>
+
+<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>
diff --git a/files/fr/mozilla/add-ons/webextensions/api/alarms/get/index.html b/files/fr/mozilla/add-ons/webextensions/api/alarms/get/index.html
new file mode 100644
index 0000000000..95b27d40b2
--- /dev/null
+++ b/files/fr/mozilla/add-ons/webextensions/api/alarms/get/index.html
@@ -0,0 +1,62 @@
+---
+title: alarms.get()
+slug: Mozilla/Add-ons/WebExtensions/API/alarms/get
+tags:
+  - API
+  - Add-ons
+  - Extensions
+  - Méthode
+  - Non-standard
+  - Reference
+  - WebExtensions
+  - alarms
+  - get
+translation_of: Mozilla/Add-ons/WebExtensions/API/alarms/get
+---
+<div>{{AddonSidebar}}</div>
+
+<p>Cette méthode permet d'obtenir une alarme en fonction de son nom. Cette fonction est une fonction asynchrone qui renvoie une promesse ({{jsxref("Promise")}}).</p>
+
+<h2 id="Syntaxe">Syntaxe</h2>
+
+<pre class="syntaxbox brush:js">var getAlarm = browser.alarms.get(
+  name  // optional string
+)
+</pre>
+
+<h3 id="Paramètres">Paramètres</h3>
+
+<dl>
+ <dt><code>name</code>{{optional_inline}}</dt>
+ <dd><code><code>string</code></code>. Le nom de l'alarme qu'on souhaite récupérer. La valeur par défaut, utilisée si aucun argument n'est fournie, sera la chaîne vide (<code>""</code>).</dd>
+</dl>
+
+<h3 id="Valeur_de_retour">Valeur de retour</h3>
+
+<p>Une promesse ({{jsxref("Promise")}}) qui sera tenue avec un objet {{WebExtAPIRef('alarms.Alarm', "Alarm")}}. Cette valeur correspond à l'alarme dont le nom correspond au paramètre <code>name</code>. Si aucune alarme ne correspond, la valeur renvoyée sera <code>undefined</code>.</p>
+
+<h2 id="Exemples">Exemples</h2>
+
+<pre class="brush: js">function gotAlarm(alarm) {
+  if (alarm) {
+    console.log(alarm.name);
+  }
+}
+
+var getAlarm = browser.alarms.get("my-periodic-alarm");
+getAlarm.then(gotAlarm);</pre>
+
+<p>{{WebExtExamples}}</p>
+
+<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2>
+
+<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p>
+
+<p>{{Compat("webextensions.api.alarms.get")}}</p>
+
+<div class="note"><strong>Remerciements :</strong>
+
+<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>
diff --git a/files/fr/mozilla/add-ons/webextensions/api/alarms/getall/index.html b/files/fr/mozilla/add-ons/webextensions/api/alarms/getall/index.html
new file mode 100644
index 0000000000..eef00b26c2
--- /dev/null
+++ b/files/fr/mozilla/add-ons/webextensions/api/alarms/getall/index.html
@@ -0,0 +1,63 @@
+---
+title: alarms.getAll()
+slug: Mozilla/Add-ons/WebExtensions/API/alarms/getAll
+tags:
+  - API
+  - Add-ons
+  - Extensions
+  - Méthode
+  - Non-standard
+  - Reference
+  - WebExtensions
+  - alarms
+  - getAll
+translation_of: Mozilla/Add-ons/WebExtensions/API/alarms/getAll
+---
+<div>{{AddonSidebar}}</div>
+
+<p>Obtient toutes les alarmes actives pour le poste.</p>
+
+<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p>
+
+<h2 id="Syntaxe">Syntaxe</h2>
+
+<pre class="syntaxbox brush:js">var getAlarms = browser.alarms.getAll()
+</pre>
+
+<h3 id="Paramètres">Paramètres</h3>
+
+<p>Aucun</p>
+
+<h3 id="Valeur_de_retour">Valeur de retour</h3>
+
+<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> dont la valeur de résolution sera un tableau d'objets <code><a href="/fr/Add-ons/WebExtensions/API/alarms/Alarm" title="Information about a single alarm. This object is returned from alarms.get() and alarms.getAll(), and is passed into the alarms.onAlarm listener."><code>Alarm</code></a></code>. Chaque élément de ce tableau représente une alarme active de l'extension. Si aucune alarme n'est active, le tableau sera vide.</p>
+
+<h2 id="Exemples">Exemples</h2>
+
+<pre class="brush: js">function gotAll(alarms) {
+  for (var alarm of alarms) {
+    console.log(alarm.name);
+  }
+}
+
+var getAlarms = browser.alarms.getAll();
+getAlarms.then(gotAll);</pre>
+
+<p>{{WebExtExamples}}</p>
+
+<p> </p>
+
+<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
+
+<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p>
+
+<p>{{Compat("webextensions.api.alarms.getAll")}}</p>
+
+<p> </p>
+
+<div class="note"><strong>Remerciements :</strong>
+
+<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>
diff --git a/files/fr/mozilla/add-ons/webextensions/api/alarms/index.html b/files/fr/mozilla/add-ons/webextensions/api/alarms/index.html
new file mode 100644
index 0000000000..bb5388ccaa
--- /dev/null
+++ b/files/fr/mozilla/add-ons/webextensions/api/alarms/index.html
@@ -0,0 +1,60 @@
+---
+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><span class="seoSummary">Programmer le code pour qu'il soit exécuté à un moment précis dans le futur.</span> 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"><strong>Remerciements :</strong>
+
+<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>
diff --git a/files/fr/mozilla/add-ons/webextensions/api/alarms/onalarm/index.html b/files/fr/mozilla/add-ons/webextensions/api/alarms/onalarm/index.html
new file mode 100644
index 0000000000..654714b328
--- /dev/null
+++ b/files/fr/mozilla/add-ons/webextensions/api/alarms/onalarm/index.html
@@ -0,0 +1,88 @@
+---
+title: alarms.onAlarm
+slug: Mozilla/Add-ons/WebExtensions/API/alarms/onAlarm
+tags:
+  - API
+  - Add-ons
+  - Event
+  - Extensions
+  - Non-standard
+  - Reference
+  - WebExtensions
+  - alarms
+  - onAlarm
+translation_of: Mozilla/Add-ons/WebExtensions/API/alarms/onAlarm
+---
+<div>{{AddonSidebar}}</div>
+
+<p>Cet évènement est déclenché lorsque l'alarme se déclenche.</p>
+
+<h2 id="Syntaxe">Syntaxe</h2>
+
+<pre class="syntaxbox brush:js">browser.alarms.onAlarm.addListener(listener)
+browser.alarms.onAlarm.removeListener(listener)
+browser.alarms.onAlarm.hasListener(listener)
+</pre>
+
+<p>Cet évènement possède trois méthodes :</p>
+
+<dl>
+ <dt><code>addListener(listener)</code></dt>
+ <dd>Cette méthode ajoute un gestionnaire à l'évènement.</dd>
+ <dt><code>removeListener(listener)</code></dt>
+ <dd>Cette méthode retire le gestionnaire d'évènement passé en argument.</dd>
+ <dt><code>hasListener(listener)</code></dt>
+ <dd>Cette méthode permet de vérifier si le gestionnaire d'évènement passé en argument est enregistré : elle renvoie <code>true</code> s'il est déjà présent et <code>false</code> sinon.</dd>
+</dl>
+
+<h2 id="Syntaxe_addListener">Syntaxe addListener</h2>
+
+<h3 id="Paramètres">Paramètres</h3>
+
+<dl>
+ <dt><code>listener</code></dt>
+ <dd>
+ <p>La fonction qui sera appelée lorsque l'événement se produira. La fonction recevra les arguments suivants :</p>
+
+ <dl class="reference-values">
+  <dt><code>alarm</code></dt>
+  <dd>{{WebExtAPIRef('alarms.Alarm')}}. L'alarme qui s'est déclenchée. La propriété <code>Alarm.name</code> pourra être utilisée afin de déterminer l'alarme qui s'est déclenchée.</dd>
+ </dl>
+ </dd>
+</dl>
+
+<h2 id="Exemples">Exemples</h2>
+
+<p>Voici un exemple illustrant ce qui se produit quand l'alarme se déclenche</p>
+
+<pre class="brush: js">function handleAlarm(alarmInfo) {
+  console.log("L'alarme " + alarmInfo.name + " s'est déclenchée");
+}
+
+browser.alarms.onAlarm.addListener(handleAlarm);</pre>
+
+<p>{{WebExtExamples}}</p>
+
+<p> </p>
+
+<dl>
+ <dd>
+ <dl class="reference-values">
+ </dl>
+ </dd>
+</dl>
+
+<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
+
+<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p>
+
+<p>{{Compat("webextensions.api.alarms.onAlarm")}}</p>
+
+<p> </p>
+
+<div class="note"><strong>Remerciements :</strong>
+
+<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>