Worker()
Worker()
コンストラクターは、指定された URL で指定されたスクリプトを実行する Worker
オブジェクトを作成します。このスクリプトは 同一オリジンポリシーに従わなければいけません。
メモ: data URL が 同一オリジンであるかどうかについては、ブラウザーベンダーの間で合意されていません。 Firefox 10 以降のリリースでは data URL を受け入れますが、すべてのブラウザーでそうなるとは限りません。
構文
new Worker(aURL);
new Worker(aURL, options);
引数
aURL
-
文字列で、ワーカーが実行するスクリプトの URL を表します。同一オリジンポリシーに従っていなければいけません。
options
省略可-
オブジェクトを作成するときに設定できるオプションプロパティを持つオブジェクトです。以下のプロパティが使用できます。
type
-
文字列で、作成するワーカーの種類を指定します。使用できる値は
classic
またはmodule
です。指定しない場合の既定値はclassic
です。 credentials
-
文字列で、ワーカーで使用する資格情報の種類を指定します。使用できる値は
omit
、same-origin
、include
です。指定しない場合、または type がclassic
である場合、既定値はomit
(資格情報は不要)です。 name
-
文字列で、ワーカーのスコープを表す
DedicatedWorkerGlobalScope
を識別する名前を指定します。これは主に、デバッグで役に立ちます。
例外
SecurityError
DOMException
-
文書がワーカーを起動することが許可されていない場合、例えば、 URL が不正な構文であったり、同一オリジンポリシーに違反していたりした場合に発生します。
NetworkError
DOMException
-
ワーカースクリプトの MIME タイプが不正な場合に発生します。これは常に
text/javascript
であるべきです(経緯上、他の JavaScript の MIME タイプも受け入れられる場合があります)。 SyntaxError
DOMException
-
aURL が解釈できなかった場合に発生します。
例
次のコードスニペットは Worker()
コンストラクターを使って Worker
オブジェクトを作成し、続いてそのオブジェクトの使い方を表しています。
const myWorker = new Worker("worker.js");
first.onchange = () => {
myWorker.postMessage([first.value, second.value]);
console.log("Message posted to worker");
};
完全な例を見るには、基本的な専用ワーカーの例(専用ワーカーを実行)を参照してください。
仕様書
Specification |
---|
HTML Standard # dom-worker-dev |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
所属する Worker
インターフェイス。