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 Geltungsbereich eines jeden Workers darstellt. Workers haben keinen Browsing-Kontext; dieser Geltungsbereich enthält die Informationen, die normalerweise von Window-Objekten vermittelt werden – in diesem Fall Event-Handler, die Konsole oder das zugehörige WorkerNavigator-Objekt. Jedes WorkerGlobalScope hat seine eigene Ereignisschleife.

Dieses Interface wird normalerweise von jedem Workertyp spezialisiert: DedicatedWorkerGlobalScope für dedizierte Worker, SharedWorkerGlobalScope für gemeinsame 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 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 Erstellen benutzerdefinierter Antworten auf Anfragen.

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

Bietet einen Mechanismus für Worker, um 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 anzeigt, ob der aktuelle Kontext sicher (true) oder nicht (false) ist.

WorkerGlobalScope.location Schreibgeschützt

Gibt die WorkerLocation zurück, die mit dem Worker verknüpft ist. Es handelt sich um ein spezifisches Standortobjekt, das größtenteils ein Teil des Location für Browsing-Bereiche ist, jedoch an Worker angepasst ist.

WorkerGlobalScope.navigator Schreibgeschützt

Gibt den WorkerNavigator zurück, der mit dem Worker verknüpft ist. Es handelt sich um ein spezifisches Navigator-Objekt, das größtenteils ein Teil des Navigator für Browsing-Bereiche ist, jedoch an Worker angepasst ist.

WorkerGlobalScope.origin Schreibgeschützt

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

WorkerGlobalScope.performance Schreibgeschützt

Gibt das Performance zurück, das mit dem Worker verknüpft ist. Nur ein Teil der Performance-Eigenschaften und -Methoden sind 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 zur Verwendung der Prioritized Task Scheduling API.

WorkerGlobalScope.trustedTypes Schreibgeschützt

Gibt das TrustedTypePolicyFactory-Objekt zurück, das mit dem globalen Objekt verknüpft ist, und bietet den Einstiegspunkt zur Verwendung der Trusted Types API.

WorkerGlobalScope.self Schreibgeschützt

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

Instanzmethoden

Dieses Interface erbt Methoden von der EventTarget-Schnittstelle.

WorkerGlobalScope.atob()

Decodiert einen Datenstring, der mit Base-64-Codierung codiert wurde.

WorkerGlobalScope.btoa()

Erstellt einen Base-64-codierten ASCII-String aus einem String von Binärdaten.

WorkerGlobalScope.clearInterval()

Bricht die wiederholte Ausführung ab, die mit WorkerGlobalScope.setInterval() festgelegt wurde.

WorkerGlobalScope.clearTimeout()

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

WorkerGlobalScope.createImageBitmap()

Nimmt eine Vielzahl von unterschiedlichen Bildquellen an und gibt ein Promise zurück, das zu einem ImageBitmap aufgelöst wird. Optional wird die Quelle auf das Rechteck von Pixeln zugeschnitten, das bei (sx, sy) mit der Breite sw und der Höhe sh beginnt.

WorkerGlobalScope.dump()

Ermöglicht es Ihnen, eine Nachricht an stdout zu schreiben – d.h. in Ihr Terminal. Dies ist dasselbe wie der window.dump von Firefox, jedoch für Worker.

WorkerGlobalScope.fetch()

Startet den Prozess des Abrufens einer Ressource aus dem Netzwerk.

WorkerGlobalScope.importScripts()

Importiert eines 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()

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

WorkerGlobalScope.setInterval()

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

WorkerGlobalScope.setTimeout()

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

WorkerGlobalScope.structuredClone()

Erstellt eine tiefe Kopie eines gegebenen Wertes mit dem structured clone algorithm.

WorkerGlobalScope.reportError()

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

Ereignisse

error

Wird ausgelöst, wenn ein Fehler auftritt.

languagechange

Wird im globalen/Worker-Geltungsbereichsobjekt 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 erlangt 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 auf WorkerGlobalScope nicht direkt in Ihrem Code zugreifen; jedoch werden seine Eigenschaften und Methoden von spezifischeren globalen Bereichen wie DedicatedWorkerGlobalScope und SharedWorkerGlobalScope geerbt. Beispielsweise könnten Sie ein weiteres Skript in den Worker importieren und die Inhalte des navigator-Objekts des Workers 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 von Ihnen ausgeführten Workers ist (DedicatedWorkerGlobalScope oder ein anderer) und alle globalen Worker-Geltungsbereiche Methoden, Eigenschaften usw. von WorkerGlobalScope erben, können Sie Zeilen wie die oben stehenden ausführen, ohne ein übergeordnetes Objekt anzugeben.

Spezifikationen

Specification
HTML
# the-workerglobalscope-common-interface

Browser-Kompatibilität

Siehe auch