Headers: delete() method
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.
Note: This feature is available in Web Workers.
The delete()
method of the Headers
interface deletes a header from the current Headers
object.
For security reasons, some headers can only be controlled by the user agent. These headers include the forbidden header names and forbidden response header names.
Syntax
delete(name)
Parameters
name
-
The name of the HTTP header you want to delete from the
Headers
object.
Return value
None (undefined
).
Examples
Creating an empty Headers
object is simple:
const myHeaders = new Headers(); // Currently empty
You could add a header to this using Headers.append
:
myHeaders.append("Content-Type", "image/jpeg");
myHeaders.get("Content-Type"); // Returns 'image/jpeg'
You can then delete it again:
myHeaders.delete("Content-Type");
myHeaders.get("Content-Type"); // Returns null, as it has been deleted
Specifications
Specification |
---|
Fetch # ref-for-dom-headers-delete① |
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
delete |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support