Headers : constructeur Headers()

Syntaxe

new Headers()
new Headers(init)

Paramètres

init Facultatif

Un objet contenant tous les en-têtes HTTP que vous souhaitez pré-remplir dans votre objet Headers. Il peut s'agir d'un simple littéral d'objet avec des valeurs String, d'un tableau de paires clé-valeur, où chaque paire est un tableau de chaînes de 2 éléments ; ou d'un objet Headers existant. Dans le dernier cas, le nouvel objet Headers copie ses données de l'objet Headers existant.

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 Headers.append :

mesEnTetes.append("Content-Type", "image/jpeg");
mesEnTetes.get("Content-Type"); // Retourne 'image/jpeg'

Vous pouvez également ajouter les en-têtes souhaités lors de la création de l'objet Headers. Dans l'extrait suivant, nous créons un nouvel objet Headers, en ajoutant certains en-têtes en passant un objet init au constructeur :

const enTetesHTTP = {
  "Content-Type": "image/jpeg",
  "X-My-Custom-Header": "Les licornes sont magiques",
};
const mesEnTetes = new Headers(enTetesHTTP);

Vous pouvez maintenant créer un autre objet Headers, en lui passant le premier objet Headers comme objet init :

const secondObjetEnTetes = new Headers(mesEnTetes);
secondObjetEnTetes.get("Content-Type"); // Retourne 'image/jpeg' — il hérite du premier objet Headers

Vous pouvez également ajouter les en-têtes souhaités lors de la création de l'objet Headers en utilisant un tableau bidimensionnel pour ajouter plusieurs en-têtes avec les mêmes valeurs. Dans l'extrait suivant, nous créons un nouvel objet Headers avec plusieurs en-têtes Set-Cookie en passant un tableau init au constructeur :

const enTetes = [
  ["Set-Cookie", "greeting=hello"],
  ["Set-Cookie", "name=world"],
];
const mesEnTetes = new Headers(enTetes);

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'API ServiceWorker
• Contrôle d'accès HTTP (CORS)
• HTTP