Headers:delete() 方法

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

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

参见