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

参见