Headers.append()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.
备注: 此特性在 Web Worker 中可用。
在一个Headers
对象内部,Headers
接口的 append()
方法可以追加一个新值到已存在的 headers 上,或者新增一个原本不存在的 header。
Headers.set
和 append()
两者之间的不同之处在于当指定 header 是已经存在的并且允许接收多个值时,Headers.set
会重写此值为新值,而append()
会追加到值序列的尾部。
语法
js
append(name, value)
参数
返回值
无(undefined
)。
示例
创建一个空的 Headers 对象:
js
var myHeaders = new Headers(); // Currently empty
可以通过 append() 方法添加 header:
js
myHeaders.append("Content-Type", "image/jpeg");
myHeaders.get("Content-Type"); // Returns 'image/jpeg'
如果指定 header 不存在,append()
将会添加这个 header 并赋值 . 如果指定 header 已存在并允许有多个值,append()
将会把指定值添加到值队列的末尾。
js
myHeaders.append("Accept-Encoding", "deflate");
myHeaders.append("Accept-Encoding", "gzip");
myHeaders.getAll("Accept-Encoding"); // Returns [ "deflate", "gzip" ]
要使用新值覆盖旧值,请使用Headers.set
。
规范
Specification |
---|
Fetch # ref-for-dom-headers-append① |
浏览器兼容性
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
append |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.