メインコンテンツへスキップ

Response

Response クラスは、ページによって受信されたレスポンスを表します。

メソッド​

allHeaders​

v1.15で追加 response.allHeaders

このレスポンスに関連付けられたすべてのレスポンス HTTP ヘッダーを持つオブジェクト。

使用例

await response.allHeaders();

戻り値

body​

v1.9より前に追加 response.body

レスポンスボディを持つバッファを返します。

使用例

await response.body();

戻り値

finished​

v1.9より前に追加 response.finished

このレスポンスが完了するのを待ち、常に null を返します。

使用例

await response.finished();

戻り値

frame​

v1.9より前に追加 response.frame

このレスポンスを開始した Frame を返します。

使用例

response.frame();

戻り値

fromServiceWorker​

v1.23で追加 response.fromServiceWorker

この Response が Service Worker の Fetch Handler によって処理されたかどうかを示します (例: FetchEvent.respondWith 経由など)。

使用例

response.fromServiceWorker();

戻り値

headerValue​

v1.15で追加 response.headerValue

名前が一致するヘッダーの値を返します。名前は大文字と小文字を区別しません。複数のヘッダーが同じ名前を持つ場合 (set-cookie を除く)、それらは , で区切られたリストとして返されます。set-cookie の場合、\n 区切り文字が使用されます。ヘッダーが見つからない場合、null が返されます。

使用例

await response.headerValue(name);

引数

  • name string#

    ヘッダーの名前。

戻り値

headerValues​

v1.15で追加 response.headerValues

名前が一致するヘッダーのすべての値を返します。例: set-cookie。名前は大文字と小文字を区別しません。

使用例

await response.headerValues(name);

引数

  • name string#

    ヘッダーの名前。

戻り値

headers​

v1.9より前に追加 response.headers

レスポンス HTTP ヘッダーを持つオブジェクト。ヘッダー名は小文字です。このメソッドは、cookie 関連のものを含むセキュリティ関連のヘッダーを返さないことに注意してください。cookie 情報を含むヘッダーの完全なリストについては、response.allHeaders() を使用できます。

使用例

response.headers();

戻り値

headersArray​

v1.15で追加 response.headersArray

このレスポンスに関連付けられたすべてのリクエスト HTTP ヘッダーを持つ配列。response.allHeaders() とは異なり、ヘッダー名は大文字と小文字が区別されます。Set-Cookie など、複数のエントリを持つヘッダーは、配列に複数回表示されます。

使用例

await response.headersArray();

戻り値

json​

v1.9より前に追加 response.json

レスポンスボディの JSON 表現を返します。

このメソッドは、レスポンスボディが JSON.parse で解析可能でない場合にエラーをスローします。

使用例

await response.json();

戻り値

ok​

v1.9より前に追加 response.ok

レスポンスが成功した (ステータスコードが 200〜299 の範囲) かどうかを示すブール値を持ちます。

使用例

response.ok();

戻り値

request​

v1.9より前に追加 response.request

一致する Request オブジェクトを返します。

使用例

response.request();

戻り値

securityDetails​

v1.13で追加 response.securityDetails

SSL およびその他のセキュリティ情報を返します。

使用例

await response.securityDetails();

戻り値

  • Promise<null | Object>#

    • issuer string (オプション)

      証明書からの Issuer フィールドの Common Name コンポーネント。これは情報提供のみを目的として使用してください。オプション。

    • protocol string (オプション)

      使用された特定の TLS プロトコル。(例: TLS 1.3)。オプション。

    • subjectName string (オプション)

      証明書からの Subject フィールドの Common Name コンポーネント。これは情報提供のみを目的として使用してください。オプション。

    • validFrom number (オプション)

      この証明書が有効になる Unix タイムスタンプ (秒単位)。オプション。

    • validTo number (オプション)

      この証明書が無効になる Unix タイムスタンプ (秒単位)。オプション。

serverAddr​

v1.13で追加 response.serverAddr

サーバーの IP アドレスとポートを返します。

使用例

await response.serverAddr();

戻り値

status​

v1.9より前に追加 response.status

レスポンスのステータスコード (例: 成功の場合は 200) を含みます。

使用例

response.status();

戻り値

statusText​

v1.9より前に追加 response.statusText

レスポンスのステータステキスト (例: 通常、成功の場合は "OK") を含みます。

使用例

response.statusText();

戻り値

text​

v1.9より前に追加 response.text

レスポンスボディのテキスト表現を返します。

使用例

await response.text();

戻り値

url​

v1.9より前に追加 response.url

レスポンスの URL を含みます。

使用例

response.url();

戻り値