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 has()

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 has() de l'interface Headers retourne un booléen indiquant si un objet Headers contient un certain en-tête.

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

js
has(name)

Paramètres

name

Le nom de l'en-tête HTTP que vous souhaitez tester. Si le nom donné n'est pas un nom d'en-tête HTTP valide, cette méthode lève une TypeError.

Valeur de retour

Une valeur booléenne.

Exemples

Créer un objet Headers vide est simple :

js
const mesEnTetes = new Headers(); // Actuellement vide

Vous pouvez ajouter un en-tête à cet objet en utilisant Headers.append, puis tester son existence avec has() :

js
mesEnTetes.append("Content-Type", "image/jpeg");
mesEnTetes.has("Content-Type"); // Retourne true
mesEnTetes.has("Accept-Encoding"); // Retourne false

Spécifications

Spécification
Fetch
# ref-for-dom-headers-has①

Compatibilité des navigateurs

Voir aussi