Headers.get()
Experimental: 这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。
get()
方法以 ByteString
形式从 Headers 对象中返回指定 header 的全部值。如果 Header 对象中不存在请求的 header,则返回 null
。
备注: 出于安全原因,部分头信息只能被用户代理控制。这些头信息包括 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"
备注: 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