Headers.delete()

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

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

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

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

Note:出于安全原因, 部分头信息只能被用户代理控制. 这些头信息包括 forbidden header names  和 forbidden response header names (en-US).

Syntax

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 Status Comment
Fetch
delete()
Living Standard  

Browser compatibility

BCD tables only load in the browser

See also