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 bestimmtes Stück Code einmal ausführt, nachdem der Timer abgelaufen ist.
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 anzugeben, der kompiliert und ausgeführt wird, wenn der Timer abläuft. 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, "sofort" oder genauer gesagt im nächsten Ereigniszyklus zu reagieren.
Beachten Sie, dass die tatsächliche Verzögerung in beiden Fällen länger als vorgesehen sein kann; siehe Gründe für Verzögerungen länger als angegeben.
Beachten Sie auch, dass, wenn der Wert keine Zahl ist, eine implizite Typkonvertierung stillschweigend auf den Wert angewendet wird, um ihn in eine Zahl zu konvertieren — was zu unerwarteten und überraschenden Ergebnissen führen kann; siehe Nicht-Zahl Verzögerungswerte werden stillschweigend in Zahlen umgewandelt für ein Beispiel.
param1, …,paramNOptional-
Zusätzliche Argumente, die an die durch
functionRefangegebene Funktion übergeben werden.
Rückgabewert
Die setTimeout() Methode gibt eine positive ganze Zahl zurück (normalerweise im Bereich von 1 bis 2.147.483.647), die den durch den Aufruf erstellten Timer eindeutig identifiziert. Dieser Bezeichner, oft als "Timeout-ID" bezeichnet, kann an clearTimeout() übergeben werden, um den Timer abzubrechen.
Innerhalb derselben globalen Umgebung (z.B. ein spezifisches Fenster oder Worker) wird die Timeout-ID garantiert nicht für einen neuen Timer wiederverwendet, solange der ursprüngliche Timer aktiv bleibt. Separate globale Umgebungen führen jedoch ihre eigenen, unabhängigen Pools von Timer-IDs.
Beschreibung
Siehe Window.setTimeout() für detaillierte Beschreibungen.
Beispiele
Siehe Window.setTimeout() für Beispiele.
Spezifikationen
| Specification |
|---|
| HTML # dom-settimeout-dev |