Worker()
Worker() コンストラクターは引数の URL で指定されたスクリプトを実行する Worker オブジェクトを作成します。このスクリプトは 同一生成元ポリシー (SOP) に従わなければいけません。
引数の URL が無効な構文だったり SOP に違反したりしている場合、SECURITY_ERR 型の DOMException を返します。
注記: data URI が SOP に違反するかどうかをブラウザーベンダーの間で合意されていません。Gecko 10.0 (Firefox 10.0 / Thunderbird 10.0 / SeaMonkey 2.7) とそれより後のリリースでは data URI を受け入れますが、すべてのブラウザーでは、そうならない場合があります。
構文
var myWorker = new Worker(aURL, options);引数
- aURL
- Worker オブジェクトが後に実行するスクリプトの URL の
USVStringです。SOP に従っていなければいけません。 - options 省略可
- オブジェクトを作成するときに設定できるオプションプロパティを持つオブジェクトです。以下のプロパティを使用できます:
type: 作成する worker のタイプを指定するDOMString。使用できる値はclassicまたはmoduleです。指定しない場合の既定値はclassicです。credentials: worker を使用するためのクレデンシャルのタイプを指定するDOMStringです。使用できる値はomit、same-origin、includeです。指定しない場合、または worker がclassicタイプである場合はの既定値はomit(クレデンシャルは不要) です。name: worker のスコープを表すDedicatedWorkerGlobalScopeを識別する名前を示すDOMStringです。これは主に、デバッグで役に立ちます。
例外
- ドキュメントが worker の開始を許可されていない場合に、
SecurityErrorが発生します。 - スクリプトのひとつの MIME タイプが
text/csv,image/*,video/*, oraudio/*である場合にNetworkErrorが発生します。これは常にtext/javacriptであるべきです。 - aURL をパースできない場合に
SyntaxErrorが発生します。
例
次のコードスニペットは Worker() コンストラクターを使って Worker オブジェクトを作成し、続いてそのオブジェクトの使い方を表しています。
var myWorker = new Worker('worker.js');
first.onchange = function() {
myWorker.postMessage([first.value,second.value]);
console.log('Message posted to worker');
}完全な例を見るには、Basic dedicated worker example (run dedicated worker) を参照してください。
仕様
| 仕様書 | 策定状況 | コメント |
|---|---|---|
| HTML Living Standard Worker() の定義 |
現行の標準 |
ブラウザー互換性
BCD tables only load in the browser
関連項目
Worker インタフェースに属しています。