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
インタフェースに属しています。