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.
* Some parts of this feature may have varying levels of support.
Hinweis: Diese Funktion ist nur in Web Workers verfügbar.
Die setTimeout()-Methode des WorkerGlobalScope-Interfaces setzt einen Timer, der eine Funktion oder ein spezifiziertes Stück Code ausführt, sobald 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 ausgeführt wird, nachdem der Timer abgelaufen ist. code-
Eine alternative Syntax, die es Ihnen ermöglicht, einen String anstelle einer Funktion einzubinden, der kompiliert und ausgeführt wird, wenn der Timer abläuft. Diese Syntax wird nicht empfohlen, aus denselben Gründen, die das Verwenden von
eval()zu einem Sicherheitsrisiko machen. delayOptional-
Die Zeit in Millisekunden, die der Timer warten soll, bevor die spezifizierte Funktion oder der Code ausgeführt wird. Wenn dieser Parameter weggelassen wird, wird ein Wert von 0 verwendet, was bedeutet, "sofort" ausführen, oder genauer gesagt, im nächsten Ereigniszyklus.
Beachten Sie, dass in beiden Fällen die tatsächliche Verzögerung länger als beabsichtigt sein kann; siehe Gründe für längere Verzögerungen als angegeben.
Beachten Sie auch, dass, wenn der Wert keine Zahl ist, eine implizite Typumwandlung stillschweigend durchgeführt wird, um den Wert in eine Zahl zu konvertieren — was zu unerwarteten und überraschenden Ergebnissen führen kann; siehe Nicht-numerische Verzögerungswerte werden stillschweigend in Zahlen umgewandelt für ein Beispiel.
param1, …,paramNOptional-
Zusätzliche Argumente, die an die durch
functionReffestgelegte Funktion übergeben werden.
Rückgabewert
Die setTimeout()-Methode gibt eine positive ganze Zahl (typischerweise im Bereich von 1 bis 2.147.483.647) zurück, die den durch den Aufruf erstellten Timer eindeutig identifiziert. Diese Kennung, oft als "Timeout-ID" bezeichnet, kann an clearTimeout() übergeben werden, um den Timer abzubrechen.
Innerhalb derselben globalen Umgebung (z. B. eines bestimmten Fensters oder Arbeiters) wird die Timeout-ID nicht für einen neuen Timer wiederverwendet, solange der ursprüngliche Timer aktiv ist. Jedoch verwalten separate globale Umgebungen ihre eigenen unabhängigen Pools von Timer-IDs.
Beschreibung
Schauen Sie sich Window.setTimeout() für ausführliche Beschreibungen an.
Beispiele
Sehen Sie Window.setTimeout() für Beispiele.
Spezifikationen
| Specification |
|---|
| HTML # dom-settimeout-dev |