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

Headers.append()

· 52CE 我爱测

在一个`Headers`对象内部,Headers接口的 **`append()`** 方法可以追加一个新值到已存在的 headers 上,或者新增一个原本不存在的 header。

Fetch API

在一个Headers对象内部,Headers接口的 append() 方法可以追加一个新值到已存在的 headers 上,或者新增一个原本不存在的 header。

Headers.set 和 append() 两者之间的不同之处在于当指定 header 是已经存在的并且允许接收多个值时,Headers.set会重写此值为新值,而append()会追加到值序列的尾部。

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

语法

append(name, value)

参数

  • name
    • : 要追加给 Headers 对象的 HTTP 标头名称。
  • value
    • : 要追加的 HTTP 标头值。

返回值

无(undefined)。

示例

创建一个空的 Headers 对象:

var myHeaders = new Headers(); // Currently empty

可以通过 append() 方法添加 header:

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

如果指定 header 不存在,append()将会添加这个 header 并赋值 . 如果指定 header 已存在并允许有多个值,append()将会把指定值添加到值队列的末尾。

myHeaders.append("Accept-Encoding", "deflate");
myHeaders.append("Accept-Encoding", "gzip");
myHeaders.get("Accept-Encoding"); // Returns 'deflate, gzip'

要使用新值覆盖旧值,请使用Headers.set。

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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