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

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

このレスポンスがService WorkerのFetchハンドラによって処理されたかどうか(つまり、FetchEvent.respondWith経由)を示します。

使用法

response.fromServiceWorker();

戻り値


headerValue

追加されたバージョン: v1.15 response.headerValue

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

使用法

await response.headerValue(name);

引数

戻り値


headerValues

追加されたバージョン: v1.15 response.headerValues

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

使用法

await response.headerValues(name);

引数

戻り値


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フィールドのコモンネームコンポーネント。情報提供のみを目的として使用する必要があります。オプション。

    • protocol string (オプション)

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

    • subjectName string (オプション)

      証明書のSubjectフィールドのコモンネームコンポーネント。情報提供のみを目的として使用する必要があります。オプション。

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

戻り値