Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources