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
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 alledelay
Millisekunden ausgeführt wird. Die erste Ausführung erfolgt nachdelay
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 voneval()
. 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 |