跳到主要內容

Response

Response 類別代表頁面接收到的回應。

方法​

allHeaders​

新增於：v1.15 response.allHeaders

一個物件，包含與此回應相關聯的所有回應 HTTP 標頭。

用法

Response.allHeaders();

回傳

body​

在 v1.9 之前新增 response.body

傳回包含回應 body 的緩衝區。

用法

Response.body();

回傳

finished​

在 v1.9 之前新增 response.finished

等待此回應完成，永遠傳回 null。

用法

Response.finished();

回傳

frame​

在 v1.9 之前新增 response.frame

傳回啟動此回應的 Frame。

用法

Response.frame();

回傳

fromServiceWorker​

新增於：v1.23 response.fromServiceWorker

指出此回應是否由 Service Worker 的 Fetch Handler 滿足（即透過 FetchEvent.respondWith）。

用法

Response.fromServiceWorker();

回傳

headerValue​

新增於：v1.15 response.headerValue

傳回與名稱相符的標頭值。名稱不區分大小寫。如果多個標頭具有相同的名稱（除了 set-cookie），它們會以逗號和空格 , 分隔的形式傳回為列表。對於 set-cookie，則使用 \n 分隔符。如果找不到標頭，則傳回 null。

用法

Response.headerValue(name);

引數

回傳

headerValues​

新增於：v1.15 response.headerValues

傳回與名稱相符的所有標頭值，例如 set-cookie。名稱不區分大小寫。

用法

Response.headerValues(name);

引數

回傳

headers​

在 v1.9 之前新增 response.headers

一個物件，包含回應 HTTP 標頭。標頭名稱為小寫。請注意，此方法不會傳回與安全性相關的標頭，包括與 Cookie 相關的標頭。您可以使用 Response.allHeaders() 來取得包含 cookie 資訊的完整標頭列表。

用法

Response.headers();

回傳

headersArray​

新增於：v1.15 response.headersArray

一個陣列，包含與此回應相關聯的所有請求 HTTP 標頭。與 Response.allHeaders() 不同，標頭名稱不為小寫。具有多個條目的標頭，例如 Set-Cookie，會在陣列中多次出現。

用法

Response.headersArray();

回傳

ok​

在 v1.9 之前新增 response.ok

包含一個布林值，指出回應是否成功（狀態碼在 200-299 範圍內）。

用法

Response.ok();

回傳

request​

在 v1.9 之前新增 response.request

傳回相符的 Request 物件。

用法

Response.request();

回傳

securityDetails​

新增於：v1.13 response.securityDetails

傳回 SSL 和其他安全性資訊。

用法

Response.securityDetails();

回傳

  • null | SecurityDetails#

    • issuer String （選用）

      憑證中「發行者」欄位的「通用名稱」元件。僅供參考。選用。

    • protocol String （選用）

      使用的特定 TLS 協定。（例如 TLS 1.3）。選用。

    • subjectName String （選用）

      憑證中「主體」欄位的「通用名稱」元件。僅供參考。選用。

    • validFrom double （選用）

      Unix 時間戳記（以秒為單位），指定此憑證何時生效。選用。

    • validTo double （選用）

      Unix 時間戳記（以秒為單位），指定此憑證何時失效。選用。

serverAddr​

新增於：v1.13 response.serverAddr

傳回伺服器的 IP 位址和連接埠。

用法

Response.serverAddr();

回傳

  • null | ServerAddr#

    • ipAddress String

      伺服器的 IPv4 或 IPV6 位址。

    • port int

status​

在 v1.9 之前新增 response.status

包含回應的狀態碼（例如，200 表示成功）。

用法

Response.status();

回傳

statusText​

在 v1.9 之前新增 response.statusText

包含回應的狀態文字（例如，成功時通常為「OK」）。

用法

Response.statusText();

回傳

text​

在 v1.9 之前新增 response.text

傳回回應 body 的文字表示形式。

用法

Response.text();

回傳

url​

在 v1.9 之前新增 response.url

包含回應的 URL。

用法

Response.url();

回傳