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①

浏览器兼容性

另见