Headers.get() - Web API 接口参考 编辑

这是一个实验中的功能
此功能某些浏览器尚在开发中，请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订，所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

get() 方法以 ByteString 形式从Headers对象中返回指定header的全部值. 如果Header对象中不存在请求的header,则返回 null.

Note:出于安全原因, 部分头信息只能被用户代理控制. 这些头信息包括 forbidden header names  和 forbidden response header names.

Syntax

myHeaders.get(name);

Parameters

name

从Headers对象中检索的HTTP header 名,如果HTTP header中不存在指定header名则会抛出一个TypeError.

Returns

以 ByteString 形式返回检索到的值.

Example

创建一个空的Headers对象:

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

可以通过get()方法来获取header中的值:

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

如果存在多个header值,那么只有第一个值会被返回:

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

Note: Headers.getAll used to have this functionality, with Headers.get returning only the first value added to the Headers object. The latest spec has removed getAll(), and updated get() to return all values.

Specifications

Specification	Status	Comment
Fetch get()	Living Standard

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

• Desktop
• Mobile

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
Basic support	42 41 behind pref	39 (39) 34 behind pref	未实现	29 28 behind pref	未实现

Feature	Android	Firefox Mobile (Gecko)	Firefox OS (Gecko)	IE Phone	Opera Mobile	Safari Mobile	Chrome for Android
Basic support	未实现	未实现	未实现	未实现	未实现	未实现	未实现

See also

• ServiceWorker API
• HTTP access control (CORS)
• HTTP