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
js
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:
js
const myHeaders = new Headers(); // Currently empty
You could add a header to this using Headers.append
:
js
myHeaders.append("Content-Type", "image/jpeg");
myHeaders.get("Content-Type"); // Returns 'image/jpeg'
You can then delete it again:
js
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