WorkerGlobalScope

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.

Das WorkerGlobalScope-Interface der Web Workers API ist ein Interface, das den Gültigkeitsbereich eines jeden Workers darstellt. Arbeiter haben keinen Browsing-Kontext; dieser Gültigkeitsbereich enthält die Informationen, die normalerweise durch Window-Objekte vermittelt werden — in diesem Fall Ereignishandler, die Konsole oder das zugeordnete WorkerNavigator-Objekt. Jedes WorkerGlobalScope hat seine eigene Ereignisschleife.

Dieses Interface ist normalerweise auf den jeweiligen Worker-Typ spezialisiert: DedicatedWorkerGlobalScope für dedizierte Arbeiter, SharedWorkerGlobalScope für geteilte Arbeiter und ServiceWorkerGlobalScope für ServiceWorker. Die self-Eigenschaft gibt den spezialisierten Bereich für jeden Kontext zurück.

EventTarget WorkerGlobalScope

Instanz-Eigenschaften

Dieses Interface erbt Eigenschaften vom EventTarget-Interface.

WorkerGlobalScope.caches Schreibgeschützt Sicherer Kontext

Gibt das CacheStorage-Objekt zurück, das dem aktuellen Kontext zugeordnet ist. Dieses Objekt ermöglicht Funktionen wie das Speichern von Assets für die Offline-Nutzung und das Erstellen benutzerdefinierter Antworten auf Anfragen.

WorkerGlobalScope.crossOriginIsolated Schreibgeschützt

Gibt einen booleschen Wert zurück, der angibt, ob die Website sich in einem Cross-Origin-Isolationszustand befindet.

WorkerGlobalScope.crypto Schreibgeschützt

Gibt das Crypto-Objekt zurück, das mit dem globalen Objekt verbunden ist.

WorkerGlobalScope.fonts Schreibgeschützt

Gibt das FontFaceSet zurück, das mit dem Worker verbunden ist.

WorkerGlobalScope.indexedDB Schreibgeschützt

Bietet einen Mechanismus für Arbeiter, um asynchron auf Funktionen von indizierten Datenbanken zuzugreifen; gibt ein IDBFactory-Objekt zurück.

WorkerGlobalScope.isSecureContext Schreibgeschützt

Gibt einen booleschen Wert zurück, der angibt, ob der aktuelle Kontext sicher (true) oder nicht (false) ist.

WorkerGlobalScope.location Schreibgeschützt

Gibt das WorkerLocation zurück, das mit dem Worker verbunden ist. Es handelt sich um ein spezielles Location-Objekt, meist um eine Untermenge des Location für Browsing-Bereiche, jedoch an Worker angepasst.

WorkerGlobalScope.navigator Schreibgeschützt

Gibt den WorkerNavigator zurück, der dem Worker zugeordnet ist. Es handelt sich um ein spezielles Navigator-Objekt, meist eine Untermenge des Navigator für Browsing-Bereiche, jedoch an Worker angepasst.

WorkerGlobalScope.origin Schreibgeschützt

Gibt den Ursprung des globalen Objekts zurück, serialisiert als Zeichenkette.

WorkerGlobalScope.performance Schreibgeschützt

Gibt die Performance zurück, die mit dem Worker verbunden ist. Nur eine Untermenge der Eigenschaften und Methoden des Performance-Interfaces sind für Worker verfügbar.

WorkerGlobalScope.scheduler Schreibgeschützt

Gibt das Scheduler-Objekt zurück, das mit dem aktuellen Kontext verbunden ist. Dies ist der Einstiegspunkt für die Verwendung der Prioritized Task Scheduling API.

WorkerGlobalScope.trustedTypes Schreibgeschützt

Gibt das TrustedTypePolicyFactory-Objekt zurück, das mit dem globalen Objekt verbunden ist und den Einstiegspunkt für die Verwendung der Trusted Types API bietet.

WorkerGlobalScope.self Schreibgeschützt

Gibt eine Referenz auf das WorkerGlobalScope selbst zurück. Meistens ist es ein spezifischer Gültigkeitsbereich wie DedicatedWorkerGlobalScope, SharedWorkerGlobalScope oder ServiceWorkerGlobalScope.

Instanz-Methoden

Dieses Interface erbt Methoden vom EventTarget-Interface.

WorkerGlobalScope.atob()

Dekodiert eine Datenzeichenkette, die mit Base-64-Kodierung kodiert wurde.

WorkerGlobalScope.btoa()

Erstellt eine Base-64-kodierte ASCII-Zeichenkette aus einer Zeichenkette von Binärdaten.

WorkerGlobalScope.clearInterval()

Hebt die wiederholte Ausführung auf, die mit WorkerGlobalScope.setInterval() festgelegt wurde.

WorkerGlobalScope.clearTimeout()

Hebt die verzögerte Ausführung auf, die mit WorkerGlobalScope.setTimeout() festgelegt wurde.

WorkerGlobalScope.createImageBitmap()

Akzeptiert verschiedene Bildquellen und gibt ein Promise zurück, das in einem ImageBitmap aufgelöst wird. Optional wird die Quelle auf das Rechteck der Pixel beschnitten, das am Punkt (sx, sy) beginnt und die Breite sw und Höhe sh hat.

WorkerGlobalScope.dump()

Ermöglicht das Schreiben einer Nachricht auf stdout, das heißt, in Ihrem Terminal. Dies entspricht dem Firefox-window.dump für Worker.

WorkerGlobalScope.fetch()

Startet den Prozess des Abrufens einer Ressource aus dem Netzwerk.

WorkerGlobalScope.importScripts()

Importiert ein oder mehrere Skripte in den Gültigkeitsbereich des Workers. Sie können beliebig viele angeben, durch Kommas getrennt. Zum Beispiel: importScripts('foo.js', 'bar.js');.

WorkerGlobalScope.queueMicrotask()

Stellt eine Mikroaufgabe in die Warteschlange, die zu einem sicheren Zeitpunkt ausgeführt werden soll, bevor die Kontrolle an die Ereignisschleife des Browsers zurückgegeben wird.

WorkerGlobalScope.setInterval()

Plant die Ausführung einer Funktion jedes Mal, wenn eine angegebene Anzahl von Millisekunden vergeht.

WorkerGlobalScope.setTimeout()

Plant die Ausführung einer Funktion zu einem bestimmten Zeitpunkt in der Zukunft.

WorkerGlobalScope.structuredClone()

Erstellt eine tiefe Kopie eines gegebenen Werts unter Verwendung des Structured Clone Algorithmus.

WorkerGlobalScope.reportError()

Meldet einen Fehler in einem Skript und emuliert eine unbehandelte Ausnahme.

Ereignisse

error

Wird ausgelöst, wenn ein Fehler auftritt.

languagechange

Wird am globalen/Worker-Bereichsobjekt ausgelöst, wenn sich die bevorzugten Sprachen des Benutzers ändern.

offline

Wird ausgelöst, wenn der Browser den Zugang zum Netzwerk verliert und der Wert von navigator.onLine auf false wechselt.

online

Wird ausgelöst, wenn der Browser den Zugang zum Netzwerk wiedererlangt und der Wert von navigator.onLine auf true wechselt.

rejectionhandled

Wird bei behandelten Promise-Ablehnungsereignissen ausgelöst.

securitypolicyviolation

Wird ausgelöst, wenn eine Content Security Policy verletzt wird.

unhandledrejection

Wird bei unbehandelten Promise-Ablehnungsereignissen ausgelöst.

Beispiel

Sie werden nicht direkt auf WorkerGlobalScope in Ihrem Code zugreifen; seine Eigenschaften und Methoden werden jedoch von spezifischeren globalen Gültigkeitsbereichen wie DedicatedWorkerGlobalScope und SharedWorkerGlobalScope geerbt. Zum Beispiel könnten Sie ein weiteres Skript in den Worker importieren und den Inhalt des navigator-Objekts des Worker-Gültigkeitsbereichs mit den folgenden zwei Zeilen ausdrucken:

js
importScripts("foo.js");
console.log(navigator);

Hinweis: Da der globale Gültigkeitsbereich des Worker-Skripts effektiv der globale Gültigkeitsbereich des Workers ist, den Sie ausführen (DedicatedWorkerGlobalScope oder was auch immer) und alle Worker-Gültigkeitsbereiche Methoden, Eigenschaften usw. vom WorkerGlobalScope erben, können Sie Zeilen wie die oben genannten ausführen, ohne ein übergeordnetes Objekt anzugeben.

Spezifikationen

Specification
HTML
# the-workerglobalscope-common-interface

Browser-Kompatibilität

Siehe auch