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

Request : propriété headers

Baseline Widely available

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 propriété en lecture seule headers de l'interface Request contient l'objet Headers associé à la requête.

Valeur

Un objet Headers.

Exemples

Dans l'extrait suivant, nous créons une nouvelle requête à l'aide du constructeur Request() (pour un fichier image dans le même répertoire que le script), puis nous enregistrons les en-têtes de la requête dans une variable :

js
const maRequete = new Request("fleurs.jpg");
const mesEnTetes = maRequete.headers; // Headers {}

Pour ajouter un en-tête à l'objet Headers, nous utilisons Headers.append ; nous créons ensuite une nouvelle Request avec un second paramètre d'initialisation, en passant les en-têtes dans l'option init :

js
const mesEnTetes = new Headers();
mesEnTetes.append("Content-Type", "image/jpeg");

const monInit = {
  method: "GET",
  headers: mesEnTetes,
  mode: "cors",
  cache: "default",
};

const maRequete = new Request("fleurs.jpg", monInit);

const monContentType = maRequete.headers.get("Content-Type"); // retourne 'image/jpeg'

Spécifications

Specification
Fetch
# ref-for-dom-request-headers②

Compatibilité des navigateurs

Voir aussi