WorkerGlobalScope

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.

* Some parts of this feature may have varying levels of support.

Hinweis: Diese Funktion ist nur inWeb Workers verfügbar.

DasWorkerGlobalScope-Interface derWeb 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 durchWindow-Objekte vermittelt werden — in diesem Fall Ereignishandler, die Konsole oder das zugeordneteWorkerNavigator-Objekt. JedesWorkerGlobalScope hat seine eigene Ereignisschleife.

Dieses Interface ist normalerweise auf den jeweiligen Worker-Typ spezialisiert:DedicatedWorkerGlobalScope für dedizierte Arbeiter,SharedWorkerGlobalScope für geteilte Arbeiter undServiceWorkerGlobalScope fürServiceWorker. Dieself-Eigenschaft gibt den spezialisierten Bereich für jeden Kontext zurück.

Instanz-Eigenschaften

Dieses Interface erbt Eigenschaften vomEventTarget-Interface.

WorkerGlobalScope.cachesSchreibgeschütztSicherer Kontext: Gibt dasCacheStorage-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.crossOriginIsolatedSchreibgeschützt: Gibt einen booleschen Wert zurück, der angibt, ob die Website sich in einem Cross-Origin-Isolationszustand befindet.
WorkerGlobalScope.cryptoSchreibgeschützt: Gibt dasCrypto-Objekt zurück, das mit dem globalen Objekt verbunden ist.
WorkerGlobalScope.fontsSchreibgeschützt: Gibt dasFontFaceSet zurück, das mit dem Worker verbunden ist.
WorkerGlobalScope.indexedDBSchreibgeschützt: Bietet einen Mechanismus für Arbeiter, um asynchron auf Funktionen von indizierten Datenbanken zuzugreifen; gibt einIDBFactory-Objekt zurück.
WorkerGlobalScope.isSecureContextSchreibgeschützt: Gibt einen booleschen Wert zurück, der angibt, ob der aktuelle Kontext sicher (true) oder nicht (false) ist.
WorkerGlobalScope.locationSchreibgeschützt: Gibt dasWorkerLocation zurück, das mit dem Worker verbunden ist. Es handelt sich um ein spezielles Location-Objekt, meist um eine Untermenge desLocation für Browsing-Bereiche, jedoch an Worker angepasst.
WorkerGlobalScope.navigatorSchreibgeschützt: Gibt denWorkerNavigator zurück, der dem Worker zugeordnet ist. Es handelt sich um ein spezielles Navigator-Objekt, meist eine Untermenge desNavigator für Browsing-Bereiche, jedoch an Worker angepasst.
WorkerGlobalScope.originSchreibgeschützt: Gibt den Ursprung des globalen Objekts zurück, serialisiert als Zeichenkette.
WorkerGlobalScope.performanceSchreibgeschützt: Gibt diePerformance zurück, die mit dem Worker verbunden ist. Nur eine Untermenge der Eigenschaften und Methoden desPerformance-Interfaces sind für Worker verfügbar.
WorkerGlobalScope.schedulerSchreibgeschützt: Gibt dasScheduler-Objekt zurück, das mit dem aktuellen Kontext verbunden ist. Dies ist der Einstiegspunkt für die Verwendung derPrioritized Task Scheduling API.
WorkerGlobalScope.trustedTypesSchreibgeschützt: Gibt dasTrustedTypePolicyFactory-Objekt zurück, das mit dem globalen Objekt verbunden ist und den Einstiegspunkt für die Verwendung derTrusted Types API bietet.
WorkerGlobalScope.selfSchreibgeschützt: Gibt eine Referenz auf dasWorkerGlobalScope selbst zurück. Meistens ist es ein spezifischer Gültigkeitsbereich wieDedicatedWorkerGlobalScope,SharedWorkerGlobalScope oderServiceWorkerGlobalScope.

Instanz-Methoden

Dieses Interface erbt Methoden vomEventTarget-Interface.

WorkerGlobalScope.atob(): Dekodiert eine Datenzeichenkette, die mit Base-64-Kodierung kodiert wurde.
WorkerGlobalScope.btoa(): Erstellt eine Base-64-kodierteASCII-Zeichenkette aus einer Zeichenkette von Binärdaten.
WorkerGlobalScope.clearInterval(): Hebt die wiederholte Ausführung auf, die mitWorkerGlobalScope.setInterval() festgelegt wurde.
WorkerGlobalScope.clearTimeout(): Hebt die verzögerte Ausführung auf, die mitWorkerGlobalScope.setTimeout() festgelegt wurde.
WorkerGlobalScope.createImageBitmap(): Akzeptiert verschiedene Bildquellen und gibt einPromise zurück, das in einemImageBitmap 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()Veraltet Nicht standardisiert: 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 einetiefe Kopie eines gegebenen Werts unter Verwendung desStructured 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 vonnavigator.onLine auffalse wechselt.
online: Wird ausgelöst, wenn der Browser den Zugang zum Netzwerk wiedererlangt und der Wert vonnavigator.onLine auftrue wechselt.
rejectionhandled: Wird bei behandeltenPromise-Ablehnungsereignissen ausgelöst.
securitypolicyviolation: Wird ausgelöst, wenn eineContent Security Policy verletzt wird.
unhandledrejection: Wird bei unbehandeltenPromise-Ablehnungsereignissen ausgelöst.

Beispiel

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

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

Anderes globales Objekt-Interface:Window,DedicatedWorkerGlobalScope,SharedWorkerGlobalScope,ServiceWorkerGlobalScope
Andere Worker-bezogene Interfaces:Worker,WorkerLocation undWorkerNavigator
Verwendung von Web-Arbeitern

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen •Fehler mit dieser Übersetzung melden

Movatterモバイル変換