Skip to main content

Response

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

方法​

allHeaders​

Added in: v1.15 response.allHeaders

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

用法

await response.allHeaders();

回傳

body​

Added before v1.9 response.body

回傳包含回應 body 的 buffer。

用法

await response.body();

回傳

finished​

Added before v1.9 response.finished

等待此回應完成，一律回傳 null。

用法

await response.finished();

回傳

frame​

Added before v1.9 response.frame

回傳啟動此回應的 Frame。

用法

response.frame();

回傳

fromServiceWorker​

Added in: v1.23 response.fromServiceWorker

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

用法

response.fromServiceWorker();

回傳

headerValue​

Added in: v1.15 response.headerValue

回傳符合名稱的標頭值。名稱不區分大小寫。如果多個標頭具有相同的名稱（set-cookie 除外），則它們會以 , 分隔的清單形式回傳。對於 set-cookie，則使用 \n 分隔符號。如果找不到標頭，則回傳 null。

用法

await response.headerValue(name);

引數

回傳

headerValues​

Added in: v1.15 response.headerValues

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

用法

await response.headerValues(name);

引數

回傳

headers​

Added before v1.9 response.headers

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

用法

response.headers();

回傳

headersArray​

Added in: v1.15 response.headersArray

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

用法

await response.headersArray();

回傳

json​

Added before v1.9 response.json

回傳回應 body 的 JSON 表示法。

如果回應 body 無法透過 JSON.parse 剖析，此方法將會擲回錯誤。

用法

await response.json();

回傳

ok​

Added before v1.9 response.ok

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

用法

response.ok();

回傳

request​

Added before v1.9 response.request

回傳相符的 Request 物件。

用法

response.request();

回傳

securityDetails​

Added in: v1.13 response.securityDetails

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

用法

await response.securityDetails();

回傳

  • Promise<null | Object>#

    • issuer string (optional)

      憑證中「發行者」欄位的 Common Name 元件。這僅應用於資訊用途。選填。

    • protocol string (optional)

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

    • subjectName string (optional)

      憑證中「主體」欄位的 Common Name 元件。這僅應用於資訊用途。選填。

    • validFrom number (optional)

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

    • validTo number (optional)

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

serverAddr​

Added in: v1.13 response.serverAddr

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

用法

await response.serverAddr();

回傳

status​

Added before v1.9 response.status

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

用法

response.status();

回傳

statusText​

Added before v1.9 response.statusText

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

用法

response.statusText();

回傳

text​

Added before v1.9 response.text

回傳回應 body 的文字表示法。

用法

await response.text();

回傳

url​

Added before v1.9 response.url

包含回應的 URL。

用法

response.url();

回傳