Headers: append() 方法

基线 广泛可用

此功能已得到广泛认可，并在许多设备和浏览器版本上运行。它自以下时间起在所有浏览器中可用： 2017 年 3 月.

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

append() 是 Headers 接口的方法，它将一个新值附加到 Headers 对象中现有标头，或者如果该标头尚不存在则添加该标头。

set() 和 append() 之间的区别在于，如果指定的标头已存在且接受多个值，则 set() 将用新值覆盖现有值，而 append() 将在新值集中将新值附加到末尾。

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

语法

js
append(name, value)

参数

name

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

value

要添加的 HTTP 标头的值。

返回值

无 (undefined)。

示例

创建空的 Headers 对象很简单

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

您可以使用 append() 向其中添加标头

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

如果指定的标头已存在，则 append() 将将其值更改为指定的值。如果指定的标头已存在且接受多个值，则 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①

浏览器兼容性

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

另请参阅