DOM

WorkerGlobalScope インターフェイス

→●、MS

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、WindowEventHandlers、GlobalFetch のメソッドを実装しています。

標準メソッド

WorkerGlobalScope.close()

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

WorkerGlobalScope.importScripts(urls...) ●

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()

遅延処理を設定する。

イベント ハンドラー

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

WorkerGlobalScope.onerror

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

WorkerGlobalScope.onoffline

offline (en-US) イベントが発生したときに呼び出されるコードを表すイベント ハンドラー。

WorkerGlobalScope.ononline

online (en-US) イベントが発生したときに呼び出されるコードを表すイベント ハンドラー。

WorkerGlobalScope.onlanguagechange

ユーザーの選択言語を変更したときに、global／worker スコープオブジェクトで発火するイベント ハンドラー。

WorkerGlobalScope.onclose 非推奨

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

WorkerGlobalScope.onrejectionhandled 非推奨

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

WorkerGlobalScope.onunhandledrejection 非推奨

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

例

¶省く

テスト