【js】JS Headers对象

概述

Fetch API (Headers是由Fetch API衍生的？)的 Headers 接口允许您对HTTP请求和响应头执行各种操作。 这些操作包括检索，设置，添加和删除。 一个Headers对象具有关联的头列表，它最初为空，由零个或多个键值对组成。你可以使用append()方法添加 之类的方法添加到此(参见 Examples)。在该接口的所有方法中，标题名称由不区分大小写的字节序列匹配。

你可以通过 Request.headers 和Response.headers属性检索一个Headers对象, 并使用 Headers.Headers()构造函数创建一个新的Headers对象.

一个实现了Headers 的对象可以直接用于 for…of 结构中, 而不是 entries(): for (var p of myHeaders) 等价于 for (var p of myHeaders.entries()).

构造函数

语法

使用Headers() 构造方法创建一个新的Headers 对象.

var myHeaders = new Headers(init);

Parameters

init可选
通过一个包含任意 HTTP headers 的对象来预设你的 Headers. 可以是一个ByteString对象; 或者是一个已存在的 Headers 对象.

Example

创建一个空的 Headers 对象:

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

你可以使用Headers.append方法添加一个header并赋值:

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

或者你可以在Headers对象创建时添加多个header. 在下面的示例中我们创建了一个新的Headers 对象, 并通过Headers构造函数中init属性来添加多个header:

var httpHeaders = { 'Content-Type' : 'image/jpeg', 'Accept-Charset' : 'utf-8', 'X-My-Custom-Header' : 'Zeke are cool' };
var myHeaders = new Headers(httpHeaders);

你可以通过init属性将一个已存在的Headers对象来创建另一个新的Headers对象:

var secondHeadersObj = new Headers(myHeaders);
secondHeadersObj.get('Content-Type'); // Would return 'image/jpeg' — it inherits it from the first headers object

append()

在一个Headers对象内部，Headers接口的append()方法可以追加一个新值到已存在的headers上，或者新增一个原本不存在的header。

Headers.set和 append()两者之间的不同之处在于当指定header是已经存在的并且允许接收多个值时，Headers.set会重写此值为新值(新值覆盖旧值)，而append()会追加到值序列的尾部（拼接多个值）。

语法

myHeaders.append(name,value);

Parameters

• name
  要追加给Headers对象的HTTP header名称.
• value
  要追加给Headers对象的HTTP header值.

Example

创建一个空的Headers对象:

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

可以通过append()方法添加header:

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

如果指定header不存在, append()将会添加这个header并赋值 . 如果指定header已存在并允许有多个值, append()将会把指定值添加到值队列的末尾。

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

要使用新值覆盖旧值，请使用Headers.set