Request: headers property
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.
The headers
read-only property of the Request
interface contains the Headers
object associated with the request.
Value
A Headers
object.
Examples
In the following snippet, we create a new request using the Request()
constructor (for an image file in the same directory as the script), then save the request headers in a variable:
js
const myRequest = new Request("flowers.jpg");
const myHeaders = myRequest.headers; // Headers {}
To add a header to the Headers
object we use Headers.append
; we then create a new Request
along with a 2nd init parameter, passing headers in as an init option:
js
const myHeaders = new Headers();
myHeaders.append("Content-Type", "image/jpeg");
const myInit = {
method: "GET",
headers: myHeaders,
mode: "cors",
cache: "default",
};
const myRequest = new Request("flowers.jpg", myInit);
const myContentType = myRequest.headers.get("Content-Type"); // returns 'image/jpeg'
Specifications
Specification |
---|
Fetch Standard # ref-for-dom-request-headers② |
Browser compatibility
BCD tables only load in the browser