Fetch API
Headers 接口的 set() 方法为 Headers 对象中已存在的标头设置新值,或在标头不存在的情况下添加该标头。
set() 和 Headers.append 的不同之处在于:如果指定的标头已经存在且其可以接受多个值,set() 会使用新值覆盖已存在的值,而 Headers.append 将新值追加到值集合的末尾。
出于安全考虑,某些标头只能由用户代理控制。这些标头包括Forbidden_request_header和Forbidden_response_header_name。
语法
set(name, value)
参数
name- : 你想要为其设置新值的 HTTP 标头的名称。如果给定名称不属于 HTTP 标头的名称,那么该方法会抛出 TypeError。
value- : 你想要设置的新值。
返回值
无(undefined)。
示例
创建一个空的 Headers 对象很简单:
const myHeaders = new Headers(); // 目前为空
你可以使用 Headers.append 方法来添加标头,然后使用 set() 来为这个标头设置新值。
myHeaders.append("Content-Type", "image/jpeg");
myHeaders.set("Content-Type", "text/html");
如果指定的标头不存在,那么 set() 会创建它,并将其值设置为指定值。如果指定的标头存在且其可以接受多个值,那么 set() 方法将会使用新值覆盖已有的值:
myHeaders.set("Accept-Encoding", "deflate");
myHeaders.set("Accept-Encoding", "gzip");
myHeaders.get("Accept-Encoding"); // 返回“gzip”
如果你想要将新值追加到已有的值中(而不是覆盖它),那么你需要使用 Headers.append 方法。
规范
浏览器兼容性
参见
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
