Headers: delete() method
{{APIRef("Fetch API")}} {{AvailableInWorkers}}
The delete() method of the {{domxref("Headers")}}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 {{Glossary("Forbidden_request_header", "forbidden request headers")}}headers
and {{Glossary("Forbidden_response_header_name", "forbidden response header names")}}names.
Syntax
delete(name)
Parameters
name- : The name of the HTTP header you want to delete from the
Headersobject.
- : The name of the HTTP header you want to delete from the
Return value
None ({{jsxref("undefined")}}undefined).
Examples
Creating an empty Headers object is simple:
const myHeaders = new Headers(); // Currently empty
You could add a header to this using {{domxref("Headers.append")}}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
{{Specifications}}
Browser compatibility
{{Compat}}