Headers: get() 方法

Baseline 已廣泛支援

此特性已得到良好確立,可跨多種裝置和瀏覽器版本使用。自 2017 年 3 月起,所有瀏覽器均支援此特性。

注意:此功能在 Web Workers 中可用。

get() 方法屬於 Headers 介面,它返回一個位元組字串,其中包含給定名稱的 Headers 物件中某個標頭的所有值。如果請求的標頭在 Headers 物件中不存在,則返回 null

出於安全原因,某些標頭只能由使用者代理控制。這些標頭包括禁止的請求標頭禁止的響應標頭名稱

語法

js
get(name)

引數

name

要從 Headers 物件中檢索其值的 HTTP 標頭的名稱。如果給定的名稱不是 HTTP 標頭的名稱,則此方法會丟擲 TypeError。名稱不區分大小寫。

返回值

一個 String 序列,表示檢索到的標頭的值,如果未設定此標頭,則返回 null

示例

建立空的 Headers 物件很簡單

js
const myHeaders = new Headers(); // Currently empty
myHeaders.get("Not-Set"); // Returns null

你可以使用 Headers.append 向其新增標頭,然後使用 get() 檢索它

js
myHeaders.append("Content-Type", "image/jpeg");
myHeaders.get("Content-Type"); // Returns "image/jpeg"

如果標頭具有與其關聯的多個值,則位元組字串將包含所有值,其順序與它們新增到 Headers 物件中的順序相同

js
myHeaders.append("Accept-Encoding", "deflate");
myHeaders.append("Accept-Encoding", "gzip");
myHeaders.get("Accept-Encoding"); // Returns "deflate, gzip"
myHeaders
  .get("Accept-Encoding")
  .split(",")
  .map((v) => v.trimStart()); // Returns [ "deflate", "gzip" ]

規範

規範
Fetch
# ref-for-dom-headers-get①

瀏覽器相容性

另見