WorkerGlobalScope

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

Das WorkerGlobalScope Interface der Web Workers API ist ein Interface, das den Geltungsbereich eines jeden Workers darstellt. Worker haben keinen Browsing-Kontext; dieser Geltungsbereich enthält die Informationen, die normalerweise durch Window-Objekte vermittelt werden — in diesem Fall Ereignishandler, die Konsole oder das zugehörige WorkerNavigator-Objekt. Jeder WorkerGlobalScope hat seine eigene Ereignisschleife.

Dieses Interface wird normalerweise nach jedem Workertyp 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.

Instanzeigenschaften

Dieses Interface 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 Assets für die Offline-Nutzung und die Erstellung benutzerdefinierter Antworten auf Anfragen.
console Schreibgeschützt Nicht standardisiert: Gibt die mit dem Worker verknüpfte console zurück.
WorkerGlobalScope.crossOriginIsolated Schreibgeschützt: Gibt einen booleschen Wert zurück, der angibt, ob sich die Website in einem Cross-Origin-Isolationszustand befindet.
WorkerGlobalScope.crypto Schreibgeschützt: Gibt das Crypto-Objekt zurück, das dem globalen Objekt zugeordnet ist.
WorkerGlobalScope.fonts Schreibgeschützt: Gibt das FontFaceSet zurück, das dem Worker zugeordnet ist.
WorkerGlobalScope.indexedDB Schreibgeschützt: Bietet einen Mechanismus für Worker, asynchron auf Fähigkeiten 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) ist oder nicht (false).
WorkerGlobalScope.location Schreibgeschützt: Gibt das WorkerLocation zurück, das mit dem Worker verknüpft ist. Es ist ein spezifisches Ortsobjekt, größtenteils ein Teil des Location für Browsing-Kontexte, jedoch an Worker angepasst.
WorkerGlobalScope.navigator Schreibgeschützt: Gibt den WorkerNavigator zurück, der mit dem Worker verknüpft ist. Es ist ein spezifisches Navigator-Objekt, größtenteils ein Teil des Navigator für Browsing-Kontexte, jedoch an Worker angepasst.
WorkerGlobalScope.origin Schreibgeschützt: Gibt den Ursprung des globalen Objekts zurück, serialisiert als Zeichenkette.
WorkerGlobalScope.performance Schreibgeschützt: Gibt den Performance zurück, der mit dem Worker verknüpft ist. Nur ein Teil der Eigenschaften und Methoden des Performance-Interfaces steht Arbeitern zur Verfügung.
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 den Einstiegspunkt für die Nutzung der Trusted Types API bietet.
WorkerGlobalScope.self Schreibgeschützt: Gibt eine Referenz auf den WorkerGlobalScope selbst zurück. Meistens ist es ein spezifischer Geltungsbereich wie DedicatedWorkerGlobalScope, SharedWorkerGlobalScope oder ServiceWorkerGlobalScope.

Instanzmethoden

Dieses Interface erbt Methoden von der EventTarget Schnittstelle.

WorkerGlobalScope.atob(): Dekodiert eine Zeichenkette von Daten, die mit Base-64-Codierung kodiert wurden.
WorkerGlobalScope.btoa(): Erstellt eine Base-64-codierte ASCII-Zeichenkette aus einer Binärdatenzeichenkette.
WorkerGlobalScope.clearInterval(): Bricht die wiederholte Ausführung ab, die mit WorkerGlobalScope.setInterval() gesetzt wurde.
WorkerGlobalScope.clearTimeout(): Bricht die verzögerte Ausführung ab, die mit WorkerGlobalScope.setTimeout() gesetzt wurde.
WorkerGlobalScope.createImageBitmap(): Akzeptiert eine Vielzahl unterschiedlicher Bildquellen und gibt ein Promise zurück, das zu einem ImageBitmap aufgelöst wird. Optional wird die Quelle auf das Rechteck der Pixel zugeschnitten, das sich bei (sx, sy) mit der Breite sw und der Höhe sh befindet.
WorkerGlobalScope.dump() Veraltet Nicht standardisiert: Ermöglicht das Schreiben einer Nachricht in stdout — also in Ihrem Terminal. Dies entspricht Mozilla Firefox's 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 so viele angeben, wie Sie möchten, getrennt durch Kommas. Zum Beispiel: importScripts('foo.js', 'bar.js');.
WorkerGlobalScope.queueMicrotask(): Wartet einen Mikrotask in die Warteschlange ein, um zu einem sicheren Zeitpunkt vor der Rückkehr der Kontrolle zur Ereignisschleife des Browsers ausgeführt zu werden.
WorkerGlobalScope.setInterval(): Plant die Ausführung einer Funktion jedes Mal, wenn eine bestimmte Anzahl von Millisekunden vergeht.
WorkerGlobalScope.setTimeout(): Plant die Ausführung einer Funktion nach einer bestimmten Zeit.
WorkerGlobalScope.structuredClone(): Erstellt eine tiefe Kopie eines gegebenen Wertes unter Verwendung des Strukturierten Klonalgoirthmus.
WorkerGlobalScope.reportError(): Meldet einen Fehler in einem Skript, das eine unbehandelte Ausnahme emuliert.

Ereignisse

error: Wird ausgelöst, wenn ein Fehler aufgetreten ist.
languagechange: Wird vom globalen/Worker-Geltungsbereich ausgelöst, wenn sich die bevorzugten Sprachen des Benutzers ändern.
offline: Wird ausgelöst, wenn der Browser den Zugriff auf das Netzwerk verloren hat und der Wert von navigator.onLine auf false wechselt.
online: Wird ausgelöst, wenn der Browser den Zugriff auf das Netzwerk wiedererlangt hat 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; jedoch werden seine Eigenschaften und Methoden von spezifischeren globalen Geltungsbereichen 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-Geltungsbereichs mit den folgenden zwei Zeilen ausdrucken:

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

Hinweis: Da der globale Geltungsbereich des Worker-Skripts effektiv der globale Geltungsbereich des Workers ist, den Sie ausführen (DedicatedWorkerGlobalScope oder was auch immer) und alle Worker-Geltungsbereiche Methoden, Eigenschaften etc. von WorkerGlobalScope erben, können Sie Zeilen wie die obigen ausführen, ohne ein übergeordnetes Objekt anzugeben.

Spezifikationen

Specification
HTML Standard # the-workerglobalscope-common-interface

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

Andere globale Objekt-Interfaces: Window, DedicatedWorkerGlobalScope, SharedWorkerGlobalScope, ServiceWorkerGlobalScope
Weitere Worker-bezogene Schnittstellen: Worker, WorkerLocation und WorkerNavigator
Verwendung von Web-Workern