大网数据广告活动
Web 标准与前端开发

Headers:Headers() 构造函数

· 52CE 我爱测

`init` - : 通过一个包含任意 HTTP 标头的对象来预设你的 `Headers`。可以是一个带有 String 值的简单对象字面量、一个名称—值对(每个队组均为二元字符串数组)的数组,或者是一个已存在的 `Headers` 对象。对于最后一种情况,新的 `Headers` 对象从已存在的 `Headers` 对象中拷贝数据。

Fetch API

Headers() 构造方法创建一个新的 Headers 对象。

语法

new Headers()
new Headers(init)

参数

  • init
    • : 通过一个包含任意 HTTP 标头的对象来预设你的 Headers。可以是一个带有 String 值的简单对象字面量、一个名称—值对(每个队组均为二元字符串数组)的数组,或者是一个已存在的 Headers 对象。对于最后一种情况,新的 Headers 对象从已存在的 Headers 对象中拷贝数据。

示例

创建一个空的 Headers 对象:

const myHeaders = new Headers(); // 目前为空

你可以使用 Headers.append 方法添加一个标头:

myHeaders.append("Content-Type", "image/jpeg");
myHeaders.get("Content-Type"); // 返回“image/jpeg”

或者你可以在 Headers 对象创建时添加多个标头。在下面的片段中,我们通过向构造函数传递一个 init 对象作为参数来创建一个新的 Headers 对象:

const httpHeaders = {
  "Content-Type": "image/jpeg",
  "X-My-Custom-Header": "Zeke are cool",
};
const myHeaders = new Headers(httpHeaders);

你可以通过传入一个已存在的 Headers 对象作为 init 对象来创建另一个新的 Headers 对象:

const secondHeadersObj = new Headers(myHeaders);
secondHeadersObj.get("Content-Type"); // 会返回“image/jpeg”——其继承自第一个 headers 对象

你还可以在创建 Headers 对象时使用一个二维数组来添加多个具有相同值的标头。在下面的片段中,我们通过向构造函数传递一个 init 数组作为参数来创建一个新的、具有多个 Set-Cookie 标头的 Headers 对象:

const headers = [
  ["Set-Cookie", "greeting=hello"],
  ["Set-Cookie", "name=world"],
];
const myHeaders = new Headers(headers);

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。