Headers:get() 方法

基线 广泛可用

此功能已经稳定,并且可以在许多设备和浏览器版本上运行。它自以下时间起在各浏览器中可用: 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①

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅