WorkerGlobalScope: setInterval()-Methode
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 ihren Wert dynamisch als JavaScript aus.
Solche APIs sind als Injection-Sinks bekannt und potenziell ein Vektor für Cross-Site-Scripting (XSS)-Angriffe.
Sie können dieses Risiko mindern, indem Sie immer TrustedScript-Objekte anstelle von Strings zuweisen und vertrauenswürdige Typen erzwingen.
Siehe Sicherheitsüberlegungen in Window.setInterval() für weitere Informationen.
Die setInterval()-Methode des WorkerGlobalScope-Interfaces ruft wiederholt eine Funktion auf oder führt einen Code-Schnipsel mit einer festen Zeitverzögerung zwischen jedem Aufruf aus.
Sie wird häufig verwendet, um eine Verzögerung für wiederholt ausgeführte Funktionen einzustellen, wie z.B. Animationen.
Sie können das Intervall mit clearInterval() abbrechen.
Siehe Window.setInterval() für weitere Informationen.
Beachten Sie, dass Sie, wenn Sie wünschen, dass Ihre Funktion einmal nach der angegebenen Verzögerung aufgerufen wird, setTimeout() verwenden sollten.
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 ein String von beliebigem Code, der alledelayMillisekunden kompiliert und ausgeführt wird. Dies kann anstelle der Umwandlung einer Funktion verwendet werden, wird jedoch dringend abgeraten, aus den gleichen Gründen, aus denen auch die Verwendung voneval()ein Sicherheitsrisiko darstellt. delayOptional-
Die Verzögerungszeit zwischen Ausführungen der angegebenen Funktion oder des Codes in Millisekunden. Standardwert ist 0, wenn nicht angegeben. Details zu den zulässigen Werten von
delayfinden Sie unter Delay-Beschränkungen inWindow.setInterval. param1, …,paramNOptional-
Zusätzliche Argumente, die an die von func angegebene Funktion weitergereicht werden, sobald der Timer abläuft.
Rückgabewert
Ein positiver Integer (normalerweise im Bereich von 1 bis 2.147.483.647), der 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.
Ausnahmen
SyntaxError-
Der
codekann nicht als Skript geparst werden. TypeError-
Wird ausgelöst, wenn der
code-Parameter auf einen String gesetzt ist, während Vertrauenswürdige Typen durch CSP erzwungen werden und keine Standardrichtlinie definiert ist. Wird ebenfalls ausgelöst, wenn der erste Parameter nicht einer der unterstützten Typen ist: eine Funktion, ein String oderTrustedScript.
Beispiele
Siehe setInterval() für Beispiele.
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-setinterval-dev |