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

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 delete() de l'interface Headers supprime un en-tête de l'objet Headers actuel.

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
delete(name)

Paramètres

name

Le nom de l'en-tête HTTP que vous souhaitez supprimer de l'objet Headers.

Valeur de retour

Aucune (undefined).

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 :

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

Vous pouvez ensuite le supprimer à nouveau :

js
mesEnTetes.delete("Content-Type");
mesEnTetes.get("Content-Type"); // Retourne null, car il a été supprimé

Spécifications

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

Compatibilité des navigateurs

Voir aussi