Headers.get()

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

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

备注:出于安全原因,部分头信息只能被用户代理控制。这些头信息包括 forbidden header namesforbidden 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
Fetch Standard
# ref-for-dom-headers-get①

Browser compatibility

BCD tables only load in the browser

See also