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.
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 desLocation
für Browsing-Kontexte, jedoch an Worker angepasst. -
Gibt den
WorkerNavigator
zurück, der mit dem Worker verknüpft ist. Es ist ein spezifisches Navigator-Objekt, größtenteils ein Teil desNavigator
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 desPerformance
-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 wieDedicatedWorkerGlobalScope
,SharedWorkerGlobalScope
oderServiceWorkerGlobalScope
.
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 einemImageBitmap
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
auffalse
wechselt. online
-
Wird ausgelöst, wenn der Browser den Zugriff auf das Netzwerk wiedererlangt hat und der Wert von
navigator.onLine
auftrue
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
undWorkerNavigator
- Verwendung von Web-Workern