alarms.create()

name Optional

string. Ein Name für den Alarm. Standardmäßig ist dies der leere String.

Dies kann verwendet werden, um auf einen bestimmten Alarm in alarms.get() und alarms.clear() zu verweisen. Er wird auch in alarms.onAlarm als name-Eigenschaft des im Listener übergebenen alarms.Alarm-Objekts verfügbar sein.

Alarmnamen sind innerhalb des Bereichs einer einzelnen Erweiterung eindeutig. Wenn ein Alarm mit einem identischen Namen existiert, wird der bestehende Alarm gelöscht und der zu erstellende Alarm wird ihn ersetzen.

alarmInfo Optional

object. Dies können Sie verwenden, um festzulegen, wann der Alarm zunächst ausgelöst wird, entweder als absoluter Wert (when) oder als Verzögerung ab dem Zeitpunkt der Alarmeinstellung (delayInMinutes). Um den Alarm zu wiederholen, geben Sie periodInMinutes an.

In Chrome dürfen, sofern die Erweiterung nicht ungepackt geladen ist, Alarme, die sie erstellt, nicht häufiger als einmal pro Minute ausgelöst werden. Wenn eine Erweiterung versucht, delayInMinutes auf einen Wert < 1 oder when auf einen Wert < 1 Minute in der Zukunft zu setzen, wird der Alarm nach 1 Minute ausgelöst. Wenn eine Erweiterung versucht, periodInMinutes auf einen Wert < 1 zu setzen, wird der Alarm jede Minute ausgelöst.

Das alarmInfo-Objekt kann die folgenden Eigenschaften enthalten:

when Optional

double. Die Zeit, zu der der Alarm zuerst ausgelöst wird, angegeben als Millisekunden seit der Epoche. Um die Anzahl der Millisekunden zwischen der Epoche und der aktuellen Zeit zu erhalten, verwenden Sie Date.now(). Wenn Sie when angeben, geben Sie nicht delayInMinutes an.

delayInMinutes Optional

double. Die Zeit, zu der der Alarm zuerst ausgelöst wird, angegeben in Minuten ab dem Zeitpunkt der Alarmeinstellung. Wenn Sie delayInMinutes angeben, geben Sie when nicht an.

periodInMinutes Optional

double. Wenn dies angegeben ist, wird der Alarm nach seiner ersten Auslösung alle periodInMinutes erneut ausgelöst. Wenn Sie diesen Wert angeben, können Sie sowohl when als auch delayInMinutes weglassen, und der Alarm wird dann zunächst nach periodInMinutes ausgelöst. Wenn periodInMinutes nicht angegeben ist, wird der Alarm nur einmal ausgelöst.

Erstellen Sie einen einmaligen Verzögerungsalarm mit "" als Namen:

const delayInMinutes = 5;

browser.alarms.create({
  delayInMinutes,
});

Erstellen Sie einen periodischen Verzögerungsalarm namens "my-periodic-alarm":

const delayInMinutes = 5;
const periodInMinutes = 2;

browser.alarms.create("my-periodic-alarm", {
  delayInMinutes,
  periodInMinutes,
});

Erstellen Sie einen periodischen absoluten Alarm namens "my-periodic-alarm":

const when = 1545696000;
const periodInMinutes = 2;

browser.alarms.create("my-periodic-alarm", {
  when,
  periodInMinutes,
});