WorkerGlobalScope: setTimeout() 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.
Hinweis: Diese Funktion ist nur in Web Workers verfügbar.
Die setTimeout()-Methode des WorkerGlobalScope-Interfaces setzt einen Timer, der eine Funktion oder einen angegebenen Code einmal ausführt, wenn der Timer abläuft.
Syntax
setTimeout(code)
setTimeout(code, delay)
setTimeout(functionRef)
setTimeout(functionRef, delay)
setTimeout(functionRef, delay, param1)
setTimeout(functionRef, delay, param1, param2)
setTimeout(functionRef, delay, param1, param2, /* …, */ paramN)
Parameter
functionRef-
Eine
function, die nach Ablauf des Timers ausgeführt wird. code-
Eine alternative Syntax, die es Ihnen ermöglicht, einen String anstelle einer Funktion zu übergeben, der beim Ablaufen des Timers kompiliert und ausgeführt wird. Diese Syntax wird nicht empfohlen, aus den gleichen Gründen, die die Verwendung von
eval()zu einem Sicherheitsrisiko machen. delayOptional-
Die Zeit in Millisekunden, die der Timer warten soll, bevor die angegebene Funktion oder der Code ausgeführt wird. Wenn dieser Parameter weggelassen wird, wird ein Wert von 0 verwendet, was bedeutet, dass "sofort" ausgeführt werden soll, oder genauer gesagt, im nächsten Ereigniszyklus.
Beachten Sie, dass die tatsächliche Verzögerung in beiden Fällen länger als beabsichtigt sein kann; siehe Gründe für längere Verzögerungen als angegeben.
Beachten Sie außerdem, dass, wenn der Wert keine Zahl ist, eine implizite Typumwandlung leise auf den Wert angewendet wird, um ihn in eine Zahl umzuwandeln - was zu unerwarteten und überraschenden Ergebnissen führen kann; siehe Nicht-nummerische Verzögerungswerte werden leise in Zahlen umgewandelt für ein Beispiel.
param1, …,paramNOptional-
Zusätzliche Argumente, die an die durch
functionRefangegebene Funktion übergeben werden.
Rückgabewert
Der zurückgegebene timeoutID ist ein positiver ganzzahliger Wert, der
den durch den Aufruf von setTimeout() erstellten Timer identifiziert. Dieser Wert kann an clearTimeout() übergeben werden, um den Timeout abzubrechen.
Es ist garantiert, dass ein timeoutID-Wert niemals von einem nachfolgenden Aufruf von setTimeout() oder setInterval() im selben Worker wiederverwendet wird, solange der Timer noch aktiv ist. Verschiedene Objekte verwenden jedoch getrennte ID-Pools.
Beschreibung
Siehe Window.setTimeout() für detaillierte Beschreibungen.
Beispiele
Siehe Window.setTimeout() für Beispiele.
Spezifikationen
| Specification |
|---|
| HTML Standard # dom-settimeout-dev |
Browser-Kompatibilität
BCD tables only load in the browser