Headers în JavaScript

Cereri HTTP și comunicare Browserele moderne, Node.js 18+

Antetele unei cereri sau ale unui răspuns HTTP, cu nume care nu țin cont de majuscule.

Sintaxă
const h = new Headers({ "Content-Type": "application/json" });
h.get(nume)
h.set(nume, valoare)
h.append(nume, valoare)
h.has(nume)
h.delete(nume)

Ce face Headers

Un obiect Headers păstrează antete HTTP: get citește o valoare (null dacă lipsește), set o înlocuiește, append adaugă încă o valoare la același nume, has verifică existența, iar delete o șterge.

Numele nu țin cont de majuscule (Content-Type și content-type sunt același antet). Mai multe valori adăugate cu append sunt citite împreună, separate prin virgulă. Obiectul poate fi parcurs cu for...of.

Parametri

Parametru Descriere
initial Opțional. Un obiect, un tablou de perechi sau alt Headers.

Ce returnează

Un obiect Headers.

Exemple

Exemplul 1: Operațiile de bază

const h = new Headers({ "Content-Type": "application/json" });

h.set("Authorization", "Bearer abc123");
h.append("Accept-Language", "ro");
h.append("Accept-Language", "en;q=0.8");

console.log(h.get("content-type"), h.has("AUTHORIZATION"));
console.log(h.get("accept-language"));
h.delete("Authorization");
console.log([...h]);
console.log(h.get("X-Lipsa"));

Rezultat

application/json true
ro, en;q=0.8
[
  [ 'accept-language', 'ro, en;q=0.8' ],
  [ 'content-type', 'application/json' ]
]
null

Exemplul 2: Antetele unui răspuns fetch

const raspuns = await fetch("https://www.dexblog.ro/wp-json/");

console.log(raspuns.headers.get("content-type"));

Rezultat posibil (depinde de răspunsul serverului)

application/json; charset=UTF-8

Greșeli frecvente

  • Citești antetele unui răspuns de pe alt domeniu și primești null. Din motive de securitate (CORS), browserul arată doar antetele permise explicit de server.

Comenzi înrudite

  • fetch: Trimite o cerere HTTP la un server și primește răspunsul, fără reîncărcarea paginii.
  • Response (json, text, blob): Răspunsul unei cereri fetch: starea, antetele și metodele care citesc conținutul ca JSON, text sau date binare.
  • new Request(): Descrie o cerere HTTP ca obiect (adresă, metodă, antete, corp), pe care o dai apoi lui fetch.