WorkerGlobalScope: fetch() メソッド

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2017年3月.

* Some parts of this feature may have varying levels of support.

メモ: この機能はウェブワーカー内でのみ利用可能です。

WorkerGlobalScope インターフェイスのfetch() メソッドは、ネットワークからリソースをフェッチする処理を開始し、レスポンスが利用可能になると解決するプロミスを返します。

このプロミスは、リクエストに対するレスポンスを表すResponse オブジェクトで解決します。

fetch() のプロミスは、リクエストを送る URL の書式が不正だったり、ネットワークエラーが発生したりなど、リクエストに失敗したときのみ拒否されます。fetch() のプロミスは、サーバーがエラーを表す HTTP ステータスコード (404 や504 など) で応答した場合は拒否されません。かわりに、then() のハンドラーはResponse.ok やResponse.status プロパティをチェックしなければなりません。

fetch() メソッドは、取得しようとしているリソースのディレクティブではなく、Content Security Policy のconnect-src ディレクティブにより制御されます。

メモ:fetch() メソッドの引数は、Request() コンストラクターの引数と同一です。

構文

fetch(resource)fetch(resource, options)

引数

resource

フェッチしたいリソースを定義します。以下を指定できます。

フェッチしたいリソースの URL を表す文字列または文字列化子を持つその他のオブジェクト (URL オブジェクトなど)。この URL には、ベース URL (ウィンドウコンテキストでは文書のbaseURI、ワーカーコンテキストではWorkerGlobalScope.location) からの相対 URL も使用できます。
Request オブジェクト

options省略可

リクエストに適用したいカスタム設定をすべて格納したRequestInit オブジェクトです。

返値

Response オブジェクトで解決するPromise です。

例外

AbortErrorDOMException: リクエストはAbortController のabort() メソッドの呼び出しにより中止されました。
NotAllowedErrorDOMException: Topics API の使用がbrowsing-topics機能ポリシーにより明示的に禁止されているとき、fetch() によるリクエストがbrowsingTopics: true を指定して行われると投げられます。
TypeError: フェッチ操作を行えなかったときのエラーです。このエラーが起こりうる理由の一覧は、Window.fetch() の例外を参照してください。