SharedWorker: SharedWorker() コンストラクター

構文

new SharedWorker(aURL)
new SharedWorker(aURL, name)
new SharedWorker(aURL, options)

引数

aURL

文字列で、ワーカーが実行するスクリプトの URL を表します。これは同一オリジンポリシーに従わなければなりません。

name 省略可

ワーカーのスコープを表す SharedWorkerGlobalScope の識別名を指定する文字列で、同じ共有ワーカーのインスタンスの作成やデバッグに有用です。

options 省略可

オブジェクトのインスタンスを作成する際に設定することができる、オプションプロパティを格納したオブジェクト。利用できるプロパティは以下のとおりです。

type

作成するワーカーの種類を指定する文字列です。この値には classic または module を指定することができます。指定しない場合、既定では classic が使用されます。

credentials

ワーカーに使用する資格情報の種類を指定する文字列です。値は omit、same-origin、include のいずれかです。指定しなかった場合、または type が classic の場合、既定では omit （資格情報は必要なし） が使用されます。

name

ワーカーのスコープを表す SharedWorkerGlobalScope の識別名を指定する文字列で、主にデバッグのために使用されます。

sameSiteCookies

文字列で、どの SameSite クッキー がワーカーに利用できるかを示します。以下の 2 つの値のいずれかを取ることができます。

'all'

ワーカーでは SameSite=Strict, SameSite=Lax, SameSite=None のクッキーがすべて利用できます。 このオプションはファーストパーティコンテキストでのみ対応しており、ファーストパーティコンテキストでは既定です。

'none'

ワーカーが利用できるのは SameSite=None クッキーのみです。このオプションはファーストパーティコンテキストでもサードパーティコンテキストでも対応しており、サードパーティコンテキストでは既定です。

例外

SecurityError DOMException

ドキュメントがワーカーの開始を許可されていない場合、例えば URL が無効な構文であったり、同一オリジンポリシーに違反していたり、sameSiteCookies の値が指定されたコンテキストで対応していなかった場合に発生します。

NetworkError DOMException

ワーカースクリプトの MIME 型が正しくない場合に発生します。常に text/javascript であるべきです（歴史的な理由から他の JavaScript MIME タイプも受け入れられるかもしれません）。

SyntaxError DOMException

aURL が解釈できない場合に発生します。

例

以下のコードでは、SharedWorker() コンストラクターを使用して SharedWorker オブジェクトを作成し、その後にそのオブジェクトを使用している様子を示しています。

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

myWorker.port.start();

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

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

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

完全な例は、基本的な共有ワーカーの例（共有ワーカーを実行）を参照してください。

仕様書

ブラウザーの互換性

関連情報

• 所属先の SharedWorker インターフェイス。