WorkerGlobalScope: Methode setInterval()
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Warnung:
Wenn der Parameter code verwendet wird, führt diese Methode dessen Wert dynamisch als JavaScript aus.
Solche APIs werden als Injection Sinks bezeichnet und können einen Angriffsvektor für Cross-Site-Scripting-Angriffe (XSS) darstellen.
Sie können dieses Risiko verringern, indem Sie statt Zeichenfolgen immer TrustedScript-Objekte zuweisen und Trusted Types erzwingen.
Weitere Informationen finden Sie unter Sicherheitsaspekte zu Window.setInterval().
Die Methode setInterval() der WorkerGlobalScope-Schnittstelle ruft eine Funktion wiederholt auf oder führt wiederholt einen Codeausschnitt aus. Zwischen den Ausführungen liegt jeweils eine feste Zeitspanne.
Sie wird häufig verwendet, um einen zeitlichen Abstand zwischen wiederholten Funktionsaufrufen festzulegen, beispielsweise bei Animationen.
Mit clearInterval() können Sie die wiederholte Ausführung beenden.
Weitere Informationen finden Sie unter Window.setInterval().
Wenn Ihre Funktion nach der angegebenen Verzögerung nur einmal aufgerufen werden soll, verwenden Sie stattdessen setTimeout().
Syntax
setInterval(code)
setInterval(code, delay)
setInterval(func)
setInterval(func, delay)
setInterval(func, delay, param1)
setInterval(func, delay, param1, param2)
setInterval(func, delay, param1, param3, /* …, */ paramN)
Parameter
func-
Eine
Function, die alledelayMillisekunden ausgeführt wird. Die erste Ausführung erfolgt nachdelayMillisekunden. code-
Ein
TrustedScriptoder eine Zeichenfolge mit beliebigem Code, der alledelayMillisekunden kompiliert und ausgeführt wird. Dies kann anstelle einer Funktion verwendet werden, wird aber aus denselben Sicherheitsgründen wie die Verwendung voneval()dringend abgeraten. delayOptional-
Die Zeitspanne zwischen den Ausführungen der angegebenen Funktion oder des Codes in Millisekunden. Wenn kein Wert angegeben wird, ist der Standardwert 0. Einzelheiten zum zulässigen Wertebereich von
delayfinden Sie unter Beschränkungen für Verzögerungen zuWindow.setInterval. param1, …,paramNOptional-
Zusätzliche Argumente, die nach Ablauf des Timers an die durch func angegebene Funktion übergeben werden.
Rückgabewert
Eine positive Ganzzahl (üblicherweise zwischen 1 und 2.147.483.647), die den durch den Aufruf erstellten Intervall-Timer eindeutig identifiziert.
Dieser Bezeichner, häufig als „Intervall-ID“ bezeichnet, kann an clearInterval() übergeben werden, um die wiederholte Ausführung der angegebenen Funktion zu beenden.
Ausnahmen
SyntaxError-
codekann nicht als Skript geparst werden. TypeError-
Wird ausgelöst, wenn der Parameter
codeeine Zeichenfolge enthält, während Trusted Types durch CSP erzwungen werden und keine Standardrichtlinie definiert ist. Die Ausnahme wird auch ausgelöst, wenn der erste Parameter keinem der unterstützten Typen entspricht: einer Funktion, einer Zeichenfolge oderTrustedScript.
Beispiele
Beispiele finden Sie unter setInterval().
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-setinterval-dev |