WorkerGlobalScope

Hinweis: Diese Funktion ist nur in Web Workers verfügbar.

Die WorkerGlobalScope-Schnittstelle der Web Workers API ist eine Schnittstelle, die den Geltungsbereich eines jeden Workers repräsentiert. Workers haben keinen Browserkontext; dieser Geltungsbereich beinhaltet die Informationen, die normalerweise von Window-Objekten bereitgestellt werden – in diesem Fall Ereignishandler, die Konsole oder das zugeordnete WorkerNavigator-Objekt. Jede WorkerGlobalScope-Schnittstelle hat ihre eigene Ereignisschleife.

Diese Schnittstelle wird normalerweise von jedem Worker-Typ spezialisiert: DedicatedWorkerGlobalScope für dedizierte Worker, SharedWorkerGlobalScope für geteilte Worker und ServiceWorkerGlobalScope für ServiceWorker. Die self-Eigenschaft gibt den spezialisierten Geltungsbereich für jeden Kontext zurück.

EventTarget WorkerGlobalScope

Instanz-Eigenschaften

Diese Schnittstelle erbt Eigenschaften von der EventTarget-Schnittstelle.

WorkerGlobalScope.caches Schreibgeschützt Sicherer Kontext

Gibt das CacheStorage-Objekt zurück, das mit dem aktuellen Kontext verknüpft ist. Dieses Objekt ermöglicht Funktionen wie das Speichern von Ressourcen für die Offline-Nutzung und das Generieren von benutzerdefinierten Antworten auf Anfragen.

WorkerGlobalScope.crossOriginIsolated Schreibgeschützt

Gibt einen boolean-Wert zurück, der angibt, ob die Website sich in einem Zustand der cross-origin Isolation befindet.

WorkerGlobalScope.crypto Schreibgeschützt

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

WorkerGlobalScope.fonts Schreibgeschützt

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

WorkerGlobalScope.indexedDB Schreibgeschützt

Stellt eine Mechanik bereit, mit der Worker asynchron auf die Fähigkeiten von indexierten Datenbanken zugreifen können; gibt ein IDBFactory-Objekt zurück.

WorkerGlobalScope.isSecureContext Schreibgeschützt

Gibt einen boolean-Wert zurück, der anzeigt, ob der aktuelle Kontext sicher (true) oder unsicher (false) ist.

WorkerGlobalScope.location Schreibgeschützt

Gibt das WorkerLocation zurück, das mit dem Worker verknüpft ist. Es handelt sich um ein spezifisches Location-Objekt, im Wesentlichen ein Teilmenge des Location für Browserkontexte, aber angepasst für Worker.

WorkerGlobalScope.navigator Schreibgeschützt

Gibt das WorkerNavigator-Objekt zurück, das mit dem Worker verknüpft ist. Es stellt eine spezifische Navigator-Instanz dar, im Wesentlichen eine Teilmenge des Navigator für Browserkontexte, aber angepasst für Worker.

WorkerGlobalScope.origin Schreibgeschützt

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

WorkerGlobalScope.performance Schreibgeschützt

Gibt das Performance-Objekt zurück, das mit dem Worker verknüpft ist. Nur eine Teilmenge der Eigenschaften und Methoden der Performance-Schnittstelle ist für Worker verfügbar.

WorkerGlobalScope.scheduler Schreibgeschützt

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

WorkerGlobalScope.trustedTypes Schreibgeschützt

Gibt das TrustedTypePolicyFactory-Objekt zurück, das mit dem globalen Objekt verknüpft ist, und stellt den Einstiegspunkt für die Nutzung der Trusted Types API bereit.

WorkerGlobalScope.self Schreibgeschützt

Gibt eine Referenz auf die WorkerGlobalScope selbst zurück. Meistens handelt es sich dabei um einen spezifischen Geltungsbereich wie DedicatedWorkerGlobalScope, SharedWorkerGlobalScope oder ServiceWorkerGlobalScope.

Instanz-Methoden

Diese Schnittstelle erbt Methoden von der EventTarget-Schnittstelle.

WorkerGlobalScope.atob()

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

WorkerGlobalScope.btoa()

Erstellt eine base-64-kodierte ASCII-Zeichenkette aus einer Zeichenkette mit Binärdaten.

WorkerGlobalScope.clearInterval()

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

WorkerGlobalScope.clearTimeout()

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

WorkerGlobalScope.createImageBitmap()

Akzeptiert eine Vielzahl unterschiedlicher Bildquellen und gibt ein Promise zurück, welches zu einem ImageBitmap aufgelöst wird. Optional kann die Quelle auf das Rechteck mit den Pixeln von (sx, sy) mit der Breite sw und Höhe sh beschnitten werden.

WorkerGlobalScope.dump() Veraltet Nicht standardisiert

Ermöglicht es, eine Nachricht an stdout zu schreiben – also in Ihrem Terminal. Dies ist dasselbe wie Firefox' window.dump, jedoch für Worker.

WorkerGlobalScope.fetch()

Startet den Prozess des Abrufens einer Ressource aus dem Netzwerk.

WorkerGlobalScope.importScripts()

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

WorkerGlobalScope.queueMicrotask()

Wartet eine Mikrotask ein, die zu einem sicheren Zeitpunkt vor der Rückkehr der Kontrolle in die Ereignisschleife des Browsers ausgeführt wird.

WorkerGlobalScope.setInterval()

Plant die Ausführung einer Funktion jedes Mal, wenn eine bestimmte Anzahl von Millisekunden abgelaufen ist.

WorkerGlobalScope.setTimeout()

Plant die Ausführung einer Funktion nach einer bestimmten Zeit.

WorkerGlobalScope.structuredClone()

Erstellt eine tiefe Kopie eines gegebenen Wertes unter Verwendung des strukturierter Kopieralgorithmus.

WorkerGlobalScope.reportError()

Meldet einen Fehler in einem Skript und simuliert so eine unbehandelte Ausnahme.

Ereignisse

error

Wird ausgelöst, wenn ein Fehler auftritt.

languagechange

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

offline

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

online

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

rejectionhandled

Wird ausgelöst, wenn eine Promise-Ablehnung behandelt wird.

securitypolicyviolation

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

unhandledrejection

Wird bei unbehandelten Promise-Ablehnungsereignissen ausgelöst.

Beispiel

Sie werden WorkerGlobalScope nicht direkt in Ihrem Code verwenden; seine Eigenschaften und Methoden werden jedoch von spezifischeren globalen Geltungsbereichen wie DedicatedWorkerGlobalScope und SharedWorkerGlobalScope geerbt. Zum Beispiel könnten Sie mithilfe der folgenden zwei Zeilen ein weiteres Skript in den Worker importieren und den Inhalt des navigator-Objekts des Worker-Bereichs ausgeben:

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

Hinweis: Da der globale Geltungsbereich des Worker-Skripts effektiv der globale Geltungsbereich des Workers selbst ist (DedicatedWorkerGlobalScope oder ein anderer) und alle Worker-Scopes Methoden, Eigenschaften etc. von WorkerGlobalScope erben, können Sie Zeilen wie die obigen ohne Angabe eines übergeordneten Objekts ausführen.

Spezifikationen

Specification
HTML
# the-workerglobalscope-common-interface

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
WorkerGlobalScope
dump
DeprecatedNon-standard
error event
fonts
importScripts
Strict MIME type checks for importScripts()
languagechange event
location
navigator
offline event
online event
rejectionhandled event
securitypolicyviolation event
self
unhandledrejection event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.

Siehe auch