---
title: alarms
slug: Mozilla/Add-ons/WebExtensions/API/alarms
translation_of: Mozilla/Add-ons/WebExtensions/API/alarms
---
<div>{{AddonSidebar}}</div>

<p>コードが動作するタイミングを予約します。この API は <code><a href="/ja/docs/Web/API/WindowTimers/setTimeout">setTimeout()</a></code> や <code><a href="/ja/docs/Web/API/WindowTimers/setInterval">setInterval()</a></code> と似ていますが、 alarms API はバックグラウンドで動作する点が異なります。</p>

<p>この API を利用するには "alarms" <a href="/ja/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">パーミッション</a> が必要です。</p>

<h2 id="関連する値の型">関連する値の型</h2>

<dl>
 <dt>{{WebExtAPIRef("alarms.Alarm")}}</dt>
 <dd>特定のアラームに関する情報が含まれます。</dd>
</dl>

<h2 id="メソッド">メソッド</h2>

<dl>
 <dt>{{WebExtAPIRef("alarms.create()")}}</dt>
 <dd>新しいアラームを生成します。</dd>
 <dt>{{WebExtAPIRef("alarms.get()")}}</dt>
 <dd>与えた名前に対応するアラームを取得します。</dd>
 <dt>{{WebExtAPIRef("alarms.getAll()")}}</dt>
 <dd>予約されたアラームすべてを取得します。</dd>
 <dt>{{WebExtAPIRef("alarms.clear()")}}</dt>
 <dd>与えた名前に対応するアラームを解除します。</dd>
 <dt>{{WebExtAPIRef("alarms.clearAll()")}}</dt>
 <dd>予約されたアラームすべてを解除します。</dd>
</dl>

<h2 id="イベント">イベント</h2>

<dl>
 <dt>{{WebExtAPIRef("alarms.onAlarm")}}</dt>
 <dd>アラームが動作した際に発火します。</dd>
</dl>

<h2 id="ブラウザ実装状況">ブラウザ実装状況</h2>

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

<div class="note"><strong>謝辞</strong>

<p>この API は Chromium の <a href="https://developer.chrome.com/extensions/alarms"><code>chrome.alarms</code></a> API に基づいています。</p>

<p>Microsoft Edge の実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。</p>
</div>