set() 方法在 interface sets a new value for an existing header inside a object, or adds the header if it does not already exist.

差异在 set() and Headers.append is that if the specified header already exists and accepts multiple values, set() overwrites the existing value with the new one, whereas Headers.append appends the new value to the end of the set of values.

For security reasons, some headers can only be controller by the user agent. These headers include the forbidden header names and forbidden response header names .

句法

myHeaders.set(name, value);
					

参数

名称
The name of the HTTP header you want to set to a new value. If the given name is not the name of an HTTP header, this method throws a TypeError .
value

The new value you want to set.

返回

Void.

范例

Creating an empty object is simple:

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

You could add a header to this using Headers.append , then set a new value for this header using set() :

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

If the specified header does not already exist, set() will create it and set its value to the specified value. If the specified header does already exist and does accept multiple values, set() will overwrite the existing value with the new one:

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

You'd need Headers.append to append the new value onto the values, not overwrite it.

规范

规范 状态 注释
Fetch
The definition of 'set()' in that specification.
实时标准

浏览器兼容性

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. 更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
set Chrome 42
42
41 Disabled
Disabled From version 41: this feature is behind the Experimental Web Platform Features preference. To change preferences in Chrome, visit chrome://flags.
Edge 14 Firefox 39
39
34 Disabled
Disabled From version 34: this feature is behind the dom.fetch.enabled preference. To change preferences in Firefox, visit about:config.
IE No Opera 29
29
28 Disabled
Disabled From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari No WebView Android 42 Chrome Android 42
42
41 Disabled
Disabled From version 41: this feature is behind the Experimental Web Platform Features preference. To change preferences in Chrome, visit chrome://flags.
Firefox Android No Opera Android 29
29
28 Disabled
Disabled From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari iOS No Samsung Internet Android 4.0

图例

完整支持

完整支持

不支持

不支持

实验。期望将来行为有所改变。

实验。期望将来行为有所改变。

用户必须明确启用此特征。

用户必须明确启用此特征。

另请参阅

元数据

  • 最后修改:
  1. 构造函数
    1. Headers()
  2. 方法
    1. append()
    2. delete()
    3. entries()
    4. get()
    5. getAll()
    6. has()
    7. keys()
    8. set()
    9. values()

版权所有  © 2014-2026 乐数软件    

工业和信息化部: 粤ICP备14079481号-1