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: Dieses Feature ist nur verfügbar in Web Workers.

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

js
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.

delay Optional

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, …, paramN Optional

Zusätzliche Argumente, die an die durch functionRef angegebene 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

Siehe auch