Request

これは実験段階の機能です。
この機能は複数のブラウザーで開発中の状態にあります。互換性テーブルをチェックしてください。また、実験段階の機能の構文と挙動は、仕様変更に伴い各ブラウザーの将来のバージョンで変更になる可能性があることに注意してください。

Fetch APIRequest インターフェースは、リクエストリソースを表します。

Request.Request() コンストラクタを使用することで、新しい Request オブジェクトを生成できますが、service worker の FetchEvent.request のような別の API 操作の結果として返される Request オブジェクトに遭遇することの方が多いでしょう。

コンストラクタ

Request.Request()
新しい Request オブジェクトを生成する。

プロパティ

Request.method 読取専用
リクエストメソッド(GETPOST など)を含む。
Request.url 読取専用
リクエストの URL を含む。
Request.headers 読取専用
リクエストの Headers に関連したオブジェクトを含む。
Request.context 読取専用  
リクエストのコンテクスト(たとえば、audioimageiframe など)を含む。
Request.referrer 読取専用
リクエストのリファラ( たとえば 、client)を含む。
Request.referrerPolicy 読取専用
リファラに関するポリシー(例えば no-referrer)を含む。
Request.mode 読取専用
リクエストのモード( たとえば 、cors、no-corssame-originnavigate)を含む。
Request.credentials 読取専用
リクエストのクレデンシャル( たとえば 、omitsame-origin)を含む。
Request.redirect 読取専用
リダイレクトの処理方法のためのモードを含む。followerrormanual のいずれかである。
Request.integrity 読取専用
リクエストの subresource integrity 値( たとえば 、sha256-BpfBw7ivV8q2jLiT13fxDYAe2tJllusRSZ273h2nFSE=)を含む。
Request.cache 読取専用
リクエストのキャッシュモード(たとえば、default、reload、no-cache)を含む。

Request は、Body を実装しているため、次のプロパティも利用可能です:

Body.bodyUsed 読取専用
response でボディが使われたかどうかを示す Boolean 値を保持する。

メソッド

Request.clone()
現在の Request オブジェクトのコピーを生成する。

RequestBody を実装しているため、 次のメソッドも利用可能です:

Body.arrayBuffer()
リクエスト本体を表す ArrayBuffer が解決される Promise が返る。
Body.blob()
リクエスト本体を表す Blob が解決される Promise が返る。
Body.formData()
リクエスト本体を表す FormData が解決される Promise が返る。
Body.json()
リクエスト本体を表す JSON が解決される Promise が返る。
Body.text()
リクエスト本体を表す USVString が解決される Promise が返る。

付記:Body の関数は 1 度しか呼べません。2 回目以降は空の文字列、もしくは ArrayBuffer が解決されます。

次のスニペットでは、Request() コンストラクタを使用して (スクリプトと同じディレクトリにある画像ファイルのために) 新しい request を生成し、いくつかリクエストのプロパティ値を返しています:

var myRequest = new Request('flowers.jpg');

var myURL = myRequest.url; // http://localhost:8000/flowers.jpg
var myMethod = myRequest.method; // GET
var myCred = myRequest.credentials; // omit

次に、GlobalFetch.fetch() の呼び出しパラメータとして Request オブジェクトを渡すことにで、このリクエストを取得できます。たとえば:

fetch(myRequest).then(function(response) {
      return response.blob();
    }).then(function(response) {
      var objectURL = URL.createObjectURL(response);
      myImage.src = objectURL;
    });

仕様

仕様 状態 コメント
Fetch
Request の定義
現行の標準 Initial definition

ブラウザ実装状況

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
基本サポート

42.0

39 (39)
34[1]
未サポート

29
28[1]

未サポート
Request.integrity 45.0   未サポート   未サポート
Request.redirect 46.0        
機能 Android Android Webview Firefox Mobile (Gecko) Firefox OS (Gecko) IE Phone Opera Mobile Safari Mobile Chrome for Android
基本サポート 未サポート 未サポート 未サポート 未サポート 未サポート 未サポート 未サポート 42.0
Request.integrity 未サポート 未サポート           45.0
Request.redirect 未サポート 未サポート           46.0

関連項目

ドキュメントのタグと貢献者

 このページの貢献者: Sixeight, chikoski, YuichiNukiyama
 最終更新者: Sixeight,