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

XMLHttpRequest : méthode overrideMimeType()

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 juillet 2015.

Note : Cette fonctionnalité est disponible via les Web Workers, sauf pour les Service Workers.

La méthode overrideMimeType() de l'interface XMLHttpRequest définit un type MIME autre que celui fourni par le serveur, qui est utilisé à la place lors de l'interprétation des données transférées dans une requête.

Cela peut être utilisé, par exemple, pour forcer un flux à être traité et analysé comme "text/xml", même si le serveur ne le signale pas comme tel. Cette méthode doit être appelée avant d'appeler send().

Syntaxe

js
overrideMimeType(mimeType)

Paramètres

mimeType

Une chaîne de caractères définissant le type MIME à utiliser à la place de celui défini par le serveur. Si le serveur ne définit pas de type, XMLHttpRequest suppose "text/xml".

Valeur de retour

Aucune (undefined).

Exemples

Cet exemple définit un type MIME de "text/plain", remplaçant le type indiqué par le serveur pour les données reçues.

Note : Si le serveur ne fournit pas d'en-tête Content-Type, XMLHttpRequest suppose que le type MIME est "text/xml". Si le contenu n'est pas un XML valide, une erreur « XML Parsing Error: not well-formed » se produit. Vous pouvez éviter cela en appelant overrideMimeType() pour définir un type différent.

js
// Interprète les données reçues comme du texte brut

req = new XMLHttpRequest();
req.overrideMimeType("text/plain");
req.addEventListener("load", callback);
req.open("get", url);
req.send();

Spécifications

Spécification
XMLHttpRequest
# the-overridemimetype()-method

Compatibilité des navigateurs

Voir aussi