Headers: append() 方法

Baseline 已广泛支持

此特性已得到良好确立,可跨多种设备和浏览器版本使用。自 2017 年 3 月起,所有浏览器均支持此特性。

注意:此功能在 Web Workers 中可用。

Headers 接口的 append() 方法将新值追加到 Headers 对象中现有 header 的末尾,如果该 header 不存在,则添加该 header。

set()append() 之间的区别在于,如果指定的 header 已经存在且接受多个值,则 set() 将用新值覆盖现有值,而 append() 会将新值追加到现有值集的末尾。

出于安全原因,某些标头只能由用户代理控制。这些标头包括禁止的请求标头禁止的响应标头名称

语法

js
append(name, value)

参数

name

要添加到 Headers 对象的 HTTP header 的名称。

value

要添加的 HTTP header 的值。

返回值

无(undefined)。

示例

创建空的 Headers 对象很简单

js
const myHeaders = new Headers(); // Currently empty

您可以使用 append() 添加 header

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

如果指定的 header 已经存在,append() 将更改其值为指定值。如果指定的 header 已经存在并且接受多个值,append() 会将新值追加到值集的末尾

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

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

规范

规范
Fetch
# ref-for-dom-headers-append①

浏览器兼容性

另见