CKTIS / JavaScript
Headers — en-têtes HTTP
Headers stocke les en-têtes HTTP utilisés par Fetch et permet de les lire, d’en ajouter, de les remplacer, de les supprimer et de parcourir l’objet.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
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 est une interface de Fetch, et non d’ECMAScript. Son constructeur accepte un objet, des paires ou un autre objet Headers. La casse des noms n’est pas prise en compte. Au début et à la fin d’une valeur, Fetch ne supprime que les octets d’espacement HTTP : tabulation horizontale (0x09), saut de ligne (0x0A), retour chariot (0x0D) et espace (0x20). Une espace insécable (U+00A0) en début ou en fin de valeur est acceptée et conservée.
append() ajoute une valeur ; set() remplace toutes les valeurs associées à un nom. get() regroupe les valeurs avec , et renvoie null en l’absence de valeur. has() vérifie la présence d’un nom ; delete() le supprime. L’objet est itérable.
Les noms ou valeurs non valides provoquent une TypeError. Les en-têtes de requête et de réponse sont soumis à des restrictions ; modifier avec succès un objet Headers autonome ne garantit pas que l’en-tête sera transmis.
Exemples
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"));Résultat
alpha, beta gamma false null
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.