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