SharedWorker: SharedWorker() Konstruktor

aURL

Ein String, der die URL des Skripts darstellt, das der Worker ausführen wird. Es muss die Same-Origin-Policy einhalten.

name Optional

Ein String, der einen identifizierenden Namen für den SharedWorkerGlobalScope angibt, der den Gültigkeitsbereich des Workers darstellt, was nützlich ist, um neue Instanzen desselben SharedWorkers zu erstellen und zu debuggen.

options Optional

Ein Objekt, das Optionen enthält, die beim Erstellen der Objektinstanz festgelegt werden können. Verfügbare Eigenschaften sind:

type

Ein String, der den Typ des zu erstellenden Workers angibt. Der Wert kann classic oder module sein. Wenn nicht angegeben, wird classic als Standard verwendet.

credentials

Ein String, der die Art der Anmeldeinformationen angibt, die für den Worker verwendet werden sollen. Der Wert kann omit, same-origin oder include sein. Wenn nicht angegeben oder wenn der Typ classic ist, wird omit (keine Anmeldeinformationen erforderlich) als Standard verwendet.

name

Ein String, der einen identifizierenden Namen für den SharedWorkerGlobalScope angibt, der den Gültigkeitsbereich des Workers darstellt, hauptsächlich für Debugging-Zwecke nützlich.

sameSiteCookies

Ein String, der angibt, welche SameSite-Cookies dem Worker zur Verfügung stehen sollen. Kann einen der folgenden zwei Werte haben:

'all'

SameSite=Strict, SameSite=Lax und SameSite=None-Cookies stehen dem Worker alle zur Verfügung. Diese Option wird nur in First-Party-Kontexten unterstützt und ist der Standard in First-Party-Kontexten.

'none'

Nur SameSite=None-Cookies stehen dem Worker zur Verfügung. Diese Option wird in First-Party- und Third-Party-Kontexten unterstützt und ist der Standard in Third-Party-Kontexten.

SecurityError DOMException

Wird ausgelöst, wenn das Dokument nicht berechtigt ist, Worker zu starten, zum Beispiel, wenn die URL eine ungültige Syntax hat oder wenn die Same-Origin-Policy verletzt wird, oder wenn der sameSiteCookies-Wert im gegebenen Kontext nicht unterstützt wird.

NetworkError DOMException

Wird ausgelöst, wenn der MIME-Typ des Worker-Skripts falsch ist. Er sollte immer text/javascript sein (aus historischen Gründen könnten andere JavaScript-MIME-Typen akzeptiert werden).

SyntaxError DOMException

Wird ausgelöst, wenn aURL nicht geparst werden kann.

Der folgende Codeausschnitt zeigt die Erstellung eines SharedWorker-Objekts mit dem SharedWorker()-Konstruktor und die anschließende Verwendung des Objekts:

const myWorker = new SharedWorker("worker.js");

myWorker.port.start();

first.onchange = () => {
  myWorker.port.postMessage([first.value, second.value]);
  console.log("Message posted to worker");
};

second.onchange = () => {
  myWorker.port.postMessage([first.value, second.value]);
  console.log("Message posted to worker");
};

myWorker.port.onmessage = (e) => {
  result1.textContent = e.data;
  console.log("Message received from worker");
};

Für ein vollständiges Beispiel, siehe unser einfaches Shared Worker-Beispiel (run shared worker.)

• Das SharedWorker-Interface, zu dem es gehört.