Headers.delete()
Experimental: 这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。
delete()
方法可以从 Headers 对象中删除指定 header.
下列原因将会导致该方法抛出一个TypeError
:
- header 名在 HTTP header 中是不存在的。
- header 被锁定了.
备注: 出于安全原因,部分头信息只能被用户代理控制。这些头信息包括 forbidden header names 和 forbidden 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