WorkerGlobalScope

Web Workers API の WorkerGlobalScope インターフェースは、いずれかの worker のスコープを表すインターフェースです。worker はブラウジングコンテクストを持ちません； このスコープには、通常 Window オブジェクトによって伝えられた情報が含まれます — この場合、イベントハンドラやコンソール、関連する WorkerNavigator オブジェクトのことです。ぞれぞれの WorkerGlobalScope は独自のイベントループを持ちます。

このインターフェースは通常、 それぞれの work タイプによって特化されます： dedicated workers   のための DedicatedWorkerGlobalScope と shared workers のための SharedWorkerGlobalScope、ServiceWorker のための ServiceWorkerGlobalScope です。self プロパティはそれぞれのコンテキストに特化したスコープを返します。

このインターフェースは、 EventTarget インターフェースから継承したプロパティと、 WindowTimers、 WindowBase64、 WindowEventHandlers からのプロパティを実装しています。

WorkerGlobalScope.caches 読取専用

現在のコンテキストに関連した CacheStorage オブジェクトを返す。このオブジェクトは、オフラインで使用するために資産を保存することやリクエストに対してカスタムレスポンスを生成するなどの  service worker の機能を使用できる。

WorkerGlobalScope.navigator 読取専用

worker に関連した WorkerNavigator を返す。これは特定の navigator オブジェクト、主にブラウジングスコープの Navigator ではなく、worker に適合する。

WorkerGlobalScope.self 読取専用

WorkerGlobalScope 自身の参照を返す。ほとんどの場合、 DedicatedWorkerGlobalScope や SharedWorkerGlobalScope 、ServiceWorkerGlobalScope のような特定のスコープである。

WorkerGlobalScope.location 読取専用

worker に関連した WorkerLocation を返す。これは特定の location オブジェクト、主にブラウジングスコープの Location ではなく、worker に適合する。

WorkerGlobalScope.performance 読取専用

work に関連した Performance を返す。これは、プロパティとメソッドのサブセットのみが worker で利用できることを除いて、通常の performance オブジェクトである。

WorkerGlobalScope.console 読取専用

worker に関連した Console オブジェクトを返す。

このインターフェースは、EventTarget インターフェースから継承したイベントハンドラと WindowTimers と WindowBase64 のイベントハンドラを実装しています。

WorkerGlobalScope.onerror

error イベントが発生したときに呼び出されるコードを表す EventHandler。

WorkerGlobalScope.onoffline

offline イベントが発生したときに呼び出されるコードを表す EventHandler。

WorkerGlobalScope.ononline

online イベントが発生したときに呼び出されるコードを表す EventHandler。

WorkerGlobalScope.onlanguagechange

ユーザーの選択言語を変更したときに、 global/worker スコープオブジェクトで発火する EventHandler。

WorkerGlobalScope.onclose

close イベントが発生したときに呼び出されるコードを表す EventHandler。

WorkerGlobalScope.onrejectionhandled

Promise の rejection イベントを制御するためのイベントハンドラ。

WorkerGlobalScope.onunhandledrejection

制御されていない Promise の rejection イベントのためのイベントハンドラ。

このインターフェースは、EventTarget インターフェースから併称したメソッドとWindowTimers、 WindowBase64、 WindowEventHandlers、 GlobalFetch のメソッドを実装しています。

WorkerGlobalScope.close()

効果的に特定のスコープを閉じ、 WorkerGlobalScope のイベントループにキューされているタスクを破棄する。

WorkerGlobalScope.importScripts()

worker のスコープに 1 つ以上のスクリプトをインポートする。カンマ区切りで任意の数を指定できる。例： importScripts('foo.js', 'bar.js');

WorkerGlobalScope.dump()

標準出力にメッセージを記述できる — たとえば、ターミナルに。これは Firefox の window.dump と同様に worker のためのものである。

WindowBase64.atob()

base-64 エンコーディングを使用してエンコードされた文字データをデコードする。

WindowBase64.btoa()

バイナリデータ文字列から base-64 エンコードされた ASCII 文字列を生成する。

WindowTimers.clearInterval()

WindowTimers.setInterval() を使用して設定された繰り返し処理をキャンセルする。

WindowTimers.clearTimeout()

WindowTimers.setTimeout() を使用して設定された繰り返し処理をキャンセルする。

ImageBitmapFactories.createImageBitmap()

異なるさまざまな画像ソースを受け入れ、ImageBitmap を解決する Promise を返す。

GlobalFetch.fetch()

リソースの取得プロセスを開始する。

WindowTimers.setInterval()

X ミリ秒ごとの処理実行をスケジューリングする。

WindowTimers.setTimeout()

遅延処理を設定する。

コード内で WorkerGlobalScope に直接アクセスすることはありません； しかし、DedicatedWorkerGlobalScope や SharedWorkerGlobalScope のような特定のグローバルスコープからプロパティやメソッドが継承されています。たとえば、worker にほかのスクリプトをインポートして、次の 2 行を使用して worker スコープの navigator オブジェクトのコンテンツを表示できます：

importScripts('foo.js');
console.log(navigator);

[1] Gecko 29 ではこれを WorkerConsole として実装しています。バージョン 30 からは通常の Console を使用しています。

• そのほかのグローバルオブジェクトインターフェース： Window、 DedicatedWorkerGlobalScope、 SharedWorkerGlobalScope、 ServiceWorkerGlobalScope
• そのほかの Worker 関連インターフェース： Worker、WorkerLocation、 WorkerGlobalScope、 ServiceWorkerGlobalScope
• Web Worker を使用する