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 Juli 2015.
* Some parts of this feature may have varying levels of support.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Warnung: Wenn der code Parameter verwendet wird, führt diese Methode ihren Wert dynamisch als JavaScript aus. Solche APIs sind bekannt als Injection-Sinks und stellen potenziell einen Vektor für Cross-Site-Scripting (XSS) Angriffe dar.
Sie können dieses Risiko mindern, indem Sie immer TrustedScript Objekte anstelle von Strings zuweisen und vertrauenswürdige Typen erzwingen. Weitere Informationen finden Sie unter Sicherheitsüberlegungen in Window.setInterval().
Die setInterval() Methode des WorkerGlobalScope Interface ruft wiederholt eine Funktion auf oder führt einen Codeausschnitt aus, mit einem festen Zeitabstand zwischen jedem Aufruf.
Sie wird häufig verwendet, um eine Verzögerung für Funktionen einzustellen, die immer wieder ausgeführt werden, wie zum Beispiel bei Animationen. Sie können das Intervall mit clearInterval() abbrechen. Weitere Informationen finden Sie unter Window.setInterval().
Wenn Sie möchten, dass Ihre Funktion einmal nach der angegebenen Verzögerung aufgerufen wird, verwenden Sie setTimeout().
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 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 Übergabe einer Funktion verwendet werden, ist jedoch stark abzuraten, aus den gleichen Gründen, die die Verwendung voneval()zu einem Sicherheitsrisiko machen. delayOptional-
Die Verzögerungszeit zwischen den Ausführungen der angegebenen Funktion oder des Codes, in Millisekunden. Standardmäßig 0, wenn nicht angegeben. Details zum erlaubten Bereich von
delay-Werten finden Sie unter Verzögerungsbeschränkungen inWindow.setInterval. arg1, …,argNOptional-
Zusätzliche Argumente, die an die durch func spezifizierte Funktion übergeben werden, sobald der Timer abläuft.
Rückgabewert
Eine positive ganze Zahl (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.
Ausnahmen
SyntaxError-
Der
codekann nicht als Skript geparst werden. TypeError-
Wird ausgelöst, wenn der
codeParameter auf einen String gesetzt wird, wenn vertrauenswürdige Typen durch CSP erzwungen werden und keine Standardrichtlinie definiert ist. Es wird auch 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
| Specification |
|---|
| HTML # dom-setinterval-dev |