WorkerGlobalScope

Hinweis: Dieses Feature ist nur verfügbar in Web Workers.

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.

EventTarget WorkerGlobalScope

Instanzeigenschaften

Dieses Interface erbt Eigenschaften von der EventTarget Schnittstelle.

WorkerGlobalScope.caches Nur lesbar Secure context

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 Nur lesbar Nicht standardisiert

Gibt die mit dem Worker verknüpfte console zurück.

WorkerGlobalScope.crossOriginIsolated Nur lesbar

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

WorkerGlobalScope.crypto Nur lesbar

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

WorkerGlobalScope.fonts Nur lesbar

Gibt das FontFaceSet zurück, das dem Worker zugeordnet ist.

WorkerGlobalScope.indexedDB Nur lesbar

Bietet einen Mechanismus für Worker, asynchron auf Fähigkeiten von indizierten Datenbanken zuzugreifen; gibt ein IDBFactory-Objekt zurück.

WorkerGlobalScope.isSecureContext Nur lesbar

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

WorkerGlobalScope.location Nur lesbar

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 Nur lesbar

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 Nur lesbar

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

WorkerGlobalScope.performance Nur lesbar

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 Nur lesbar

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 Nur lesbar

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 Nur lesbar

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:

js
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