主要コンテンツへスキップ

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

引数

戻り値


headerValues

v1.15で追加 response.headerValues

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

使用方法

await response.headerValues(name);

引数

戻り値


headers

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

レスポンスのHTTPヘッダーを含むオブジェクトです。ヘッダー名には小文字が使用されます。このメソッドは、クッキー関連のものを含むセキュリティ関連のヘッダーを返さないことに注意してください。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();

戻り値