Skip to main content
On this page

HTTP Headers

The Headers interface is part of the Fetch API. It allows you create and manipulate the HTTP headers of request and response resources of fetch().

Constructor Jump to heading

The Header() constructor creates a new Header instance.

let headers = new Headers(init);

Parameters Jump to heading

name type optional description
init Headers / { [key: string]: string } true The init option lets you initialize the headers object with an existing Headers or an object literal.

The return type of the constructor is a Headers instance.

Methods Jump to heading

name description
append(name: string, value: string) Appends a header (overwrites existing one) to the Headers object.
delete(name: string) Deletes a header from the Headers object.
set(name: string, value: string) Create a new header in the Headers object.
get(name: string) Get the value of the header in the Headers object.
has(name: string) Check if the header exists in the Headers objects.
entries() Get the headers as key-value pair. The result is iterable.
keys() Get all the keys of the Headers object. The result is iterable.

Example Jump to heading

// Create a new headers object from an object literal.
const myHeaders = new Headers({
  accept: "application/json",
});

// Append a header to the headers object.
myHeaders.append("user-agent", "Deno Deploy");

// Print the headers of the headers object.
for (const [key, value] of myHeaders.entries()) {
  console.log(key, value);
}

// You can pass the headers instance to Response or Request constructors.
const request = new Request("https://api.github.com/users/denoland", {
  method: "POST",
  headers: myHeaders,
});