Headers：delete() 方法

Headers 接口的 delete() 方法可以从当前 Headers 对象中删除指定标头。

下列原因将会导致该方法抛出 TypeError：

  • name 参数的值不是 HTTP 标头的名称。
  • Guard 的值为 immutable。

出于安全原因，部分标头信息只能由用户代理控制。这些标头信息包括禁止修改的标头和禁止修改的响应标头。

语法

js

delete(name)

参数

name

你想要从 Headers 对象中删除的 HTTP 标头的名称。

返回值

无（undefined）。

示例

创建一个空的 Headers 对象很简单：

js

const myHeaders = new Headers(); // 目前为空

你可以通过 Headers.append 方法添加标头：

js

myHeaders.append("Content-Type", "image/jpeg");
myHeaders.get("Content-Type"); // 返回 'image/jpeg'

然后你可以删除它。

js

myHeaders.delete("Content-Type");
myHeaders.get("Content-Type"); // 返回 null，因为它已被删除

规范

Specification
Fetch Standard
# ref-for-dom-headers-delete①

浏览器兼容性

BCD tables only load in the browser

参见