WorkerGlobalScope: setInterval() Methode

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

Hinweis: Diese Funktion ist nur in Web Workers verfügbar.

Die setInterval() Methode des WorkerGlobalScope Interfaces ruft wiederholt eine Funktion auf oder führt einen Code-Schnipsel aus, mit einer festen Zeitverzögerung zwischen jedem Aufruf.

Diese Methode ist auch in Fensterkontexten verfügbar: Eine detaillierte Beschreibung von setInterval() finden Sie auf der Seite Window.setInterval().

Syntax

js
setInterval(code)
setInterval(code, delay)

setInterval(func)
setInterval(func, delay)
setInterval(func, delay, arg1)
setInterval(func, delay, arg1, arg2)
setInterval(func, delay, arg1, arg2, /* …, */ argN)

Parameter

func

Eine function, die alle delay Millisekunden ausgeführt wird. Die erste Ausführung erfolgt nach delay Millisekunden.

code

Eine optionale Syntax, die es Ihnen ermöglicht, einen String anstelle einer Funktion einzuschließen, der kompiliert und alle delay Millisekunden ausgeführt wird. Diese Syntax wird nicht empfohlen, da sie aus denselben Gründen ein Sicherheitsrisiko darstellt wie die Verwendung von eval().

delay Optional

Die Zeit in Millisekunden (Tausendstel einer Sekunde), die der Timer zwischen den Ausführungen der angegebenen Funktion oder des Codes verzögern soll. Standardmäßig 0, wenn nicht angegeben. Siehe Verzögerungsbeschränkungen für Details zum zulässigen Bereich der delay-Werte.

arg1, …, argN Optional

Zusätzliche Argumente, die an die von func angegebene Funktion übergeben werden, sobald der Timer abläuft.

Rückgabewert

Die setInterval() Methode gibt eine positive ganze Zahl zurück (typischerweise im Bereich von 1 bis 2.147.483.647), die den durch den Aufruf erstellten Intervall-Timer eindeutig identifiziert. Dieser Bezeichner, oft als "Intervall-ID" bezeichnet, kann an clearInterval() übergeben werden, um die wiederholte Ausführung der angegebenen Funktion zu stoppen.

Innerhalb derselben globalen Umgebung (z. B. eines bestimmten Fensters oder Arbeiters) bleibt die Intervall-ID eindeutig und wird nicht für einen neuen Intervall-Timer wiederverwendet, solange der ursprüngliche Timer noch aktiv ist. Unterschiedliche globale Umgebungen haben jedoch ihre eigenen unabhängigen Pools von Intervall-IDs.

Beachten Sie, dass setInterval() und setTimeout() denselben Pool von IDs teilen und dass clearInterval() und clearTimeout() technisch austauschbar verwendet werden können. Zur Klarstellung sollten Sie jedoch versuchen, sie immer zuzuordnen, um Verwirrung bei der Pflege Ihres Codes zu vermeiden.

Hinweis: Das delay Argument wird in eine signierte 32-Bit-Ganzzahl umgewandelt. Dies begrenzt delay effektiv auf 2147483647 ms, also etwa 24,8 Tage, da es als signierte Ganzzahl in der IDL spezifiziert ist.

Beispiele

Siehe setInterval() für Beispiele.

Spezifikationen

Specification
HTML
# dom-setinterval-dev

Browser-Kompatibilität

Siehe auch