Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Headers — intestazioni HTTP

Headers memorizza le intestazioni HTTP per Fetch e consente di leggerle, aggiungere valori, sostituirli, eliminarli e scorrere l’oggetto.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

new Headers(init?)
headers.append(name, value)
headers.set(name, value)
headers.get(name)
headers.has(name)
headers.delete(name)
for (const [name, value] of headers) { /* ... */ }

Headers è un’interfaccia di Fetch, non di ECMAScript. Il costruttore accetta un oggetto, coppie o un altro oggetto Headers. Nei nomi non si distingue tra maiuscole e minuscole. All’inizio e alla fine di un valore, Fetch rimuove solo i byte di spaziatura HTTP: tabulazione orizzontale (0x09), avanzamento di riga (0x0A), ritorno a capo (0x0D) e spazio (0x20). Uno spazio non separabile (U+00A0) all’inizio o alla fine del valore è accettato e mantenuto.

append() aggiunge un valore; set() sostituisce tutti i valori associati a un nome. get() unisce i valori con , e restituisce null se non è presente alcun valore. has() verifica la presenza di un nome; delete() lo rimuove. L’oggetto è iterabile.

Nomi o valori non validi causano un TypeError. Le intestazioni di richiesta e risposta sono soggette a restrizioni; modificare con successo un oggetto Headers autonomo non garantisce che l’intestazione venga trasmessa.

Esempi

const headers = new Headers({ "X-Tag": " alpha " });
headers.append("x-tag", "beta");
console.log(headers.get("X-TAG"));
headers.set("x-tag", "gamma");
console.log(headers.get("x-tag"));
headers.delete("x-tag");
console.log(headers.has("x-tag"));
console.log(headers.get("x-tag"));

Risultato

alpha, beta
gamma
false
null

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti