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

Headers:set() 方法

· 52CE 我爱测

Headers 接口的 **`set()`** 方法为 `Headers` 对象中已存在的标头设置新值,或在标头不存在的情况下添加该标头。

Fetch API

Headers 接口的 set() 方法为 Headers 对象中已存在的标头设置新值,或在标头不存在的情况下添加该标头。

set() 和 Headers.append 的不同之处在于:如果指定的标头已经存在且其可以接受多个值,set() 会使用新值覆盖已存在的值,而 Headers.append 将新值追加到值集合的末尾。

出于安全考虑,某些标头只能由用户代理控制。这些标头包括Forbidden_request_header和Forbidden_response_header_name。

语法

set(name, value)

参数

  • name
    • : 你想要为其设置新值的 HTTP 标头的名称。如果给定名称不属于 HTTP 标头的名称,那么该方法会抛出 TypeError。
  • value
    • : 你想要设置的新值。

返回值

无(undefined)。

示例

创建一个空的 Headers 对象很简单:

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

你可以使用 Headers.append 方法来添加标头,然后使用 set() 来为这个标头设置新值。

myHeaders.append("Content-Type", "image/jpeg");
myHeaders.set("Content-Type", "text/html");

如果指定的标头不存在,那么 set() 会创建它,并将其值设置为指定值。如果指定的标头存在且其可以接受多个值,那么 set() 方法将会使用新值覆盖已有的值:

myHeaders.set("Accept-Encoding", "deflate");
myHeaders.set("Accept-Encoding", "gzip");
myHeaders.get("Accept-Encoding"); // 返回“gzip”

如果你想要将新值追加到已有的值中(而不是覆盖它),那么你需要使用 Headers.append 方法。

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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