Headers : méthode append()
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis mars 2017.
Note : Cette fonctionnalité est disponible via les Web Workers.
La méthode append() de l'interface Headers ajoute une nouvelle valeur à un en-tête existant dans un objet Headers, ou ajoute l'en-tête s'il n'existe pas déjà.
La différence entre set() et append() est que si l'en-tête défini existe déjà et accepte plusieurs valeurs, set() remplacera la valeur existante par la nouvelle, tandis que append() ajoutera la nouvelle valeur à la fin de l'ensemble des valeurs.
Pour des raisons de sécurité, certains en-têtes ne peuvent être contrôlés que par l'agent utilisateur. Ces en-têtes incluent les en-têtes de requête interdits et les noms d'en-têtes de réponse interdits.
Syntaxe
append(name, value)
Paramètres
Valeur de retour
Aucune (undefined).
Exemples
Créer un objet Headers vide est simple :
const mesEnTetes = new Headers(); // Actuellement vide
Vous pouvez ajouter un en-tête à cet objet en utilisant append() :
mesEnTetes.append("Content-Type", "image/jpeg");
mesEnTetes.get("Content-Type"); // Retourne 'image/jpeg'
Si l'en-tête défini existe déjà, append() changera sa valeur pour la valeur définie. Si l'en-tête défini existe déjà et accepte plusieurs valeurs, append() ajoutera la nouvelle valeur à la fin de l'ensemble des valeurs :
mesEnTetes.append("Accept-Encoding", "deflate");
mesEnTetes.append("Accept-Encoding", "gzip");
mesEnTetes.get("Accept-Encoding"); // Retourne 'deflate, gzip'
Pour remplacer l'ancienne valeur par une nouvelle, utilisez Headers.set.
Spécifications
| Spécification |
|---|
| Fetch # ref-for-dom-headers-append① |