Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Headers : méthode forEach()

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 forEach() de l'interface Headers exécute une fonction de rappel une fois pour chaque paire clé/valeur dans l'objet Headers.

Syntaxe

js
forEach(callbackFn)
forEach(callbackFn, thisArg)

Paramètres

callbackFn

Fonction à exécuter pour chaque entrée dans la carte d'objet. Elle prend les arguments suivants :

value

Valeur de l'entrée d'en-tête actuellement visitée.

key

Nom de l'entrée d'en-tête actuellement visitée.

object

L'objet Headers en cours d'itération.

thisArg Facultatif

Valeur à utiliser comme this lors de l'exécution du rappel.

Valeur de retour

Aucune (undefined).

Description

La méthode Headers.forEach() exécute la fonction de rappel fournie une fois pour chaque clé des en-têtes qui existent réellement. Elle n'est pas invoquée pour les clés qui ont été supprimées. Cependant, elle est exécutée pour les clés qui sont présentes mais dont la valeur est undefined.

Exemples

Afficher le contenu de l'objet Headers

Le code suivant affiche une ligne pour chaque paire clé/valeur dans l'objet mesEnTetes.

js
// Crée un objet Headers de test
const mesEnTetes = new Headers();
mesEnTetes.append("Content-Type", "application/json");
mesEnTetes.append("Cookie", "Ceci est un cookie de démonstration");
mesEnTetes.append("compression", "gzip");

// Affiche les paires clé/valeur
mesEnTetes.forEach((value, key) => {
  console.log(`${key} ==> ${value}`);
});

Le résultat est :

compression ==> gzip
content-type ==> application/json
cookie ==> Ceci est un cookie de démonstration

Compatibilité des navigateurs

Voir aussi