Headers.delete()

Experimental: 这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

delete() 方法可以从 Headers 对象中删除指定 header.

下列原因将会导致该方法抛出一个TypeError:

  • header 名在 HTTP header 中是不存在的。
  • header 被锁定了.

备注: 出于安全原因,部分头信息只能被用户代理控制。这些头信息包括 forbidden header namesforbidden response header names.

语法

myHeaders.delete(name);

Parameters

name

需删除的 HTTP header 名称。

Returns

Void.

Example

创建一个空的 Headers 对象:

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

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

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

可以通过 delete() 方法删除已有 header:

myHeaders.delete('Content-Type');
myHeaders.get('Content-Type'); // Returns null, as it has been deleted

Specifications

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

Browser compatibility

BCD tables only load in the browser

See also