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

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.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

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

Les objets XMLHttpRequest (XHR) permettent d'interagir avec des serveurs. On peut récupérer des données à partir d'une URL sans avoir à rafraîchir complètement la page. Cela permet à une page web d'être mise à jour sans perturber les actions de l'utilisateur·ice.

EventTarget XMLHttpRequestEventTarget XMLHttpRequest

Malgré son nom, XMLHttpRequest peut être utilisé afin de récupérer tout type de données et pas uniquement du XML.

Si vos opérations de communication nécessitent l'échange d'évènements ou de messages avec un serveur, pensez à utiliser les évènements serveur avec l'interface EventSource. Pour une communication bidirectionnelle complète, les WebSockets peuvent être une meilleure alternative.

Constructeur

XMLHttpRequest()

Le constructeur initialise un objet XMLHttpRequest. Il doit être appelé avant toute autre méthode.

Propriétés d'instance

Cette interface hérite également des propriétés de XMLHttpRequestEventTarget et de EventTarget.

XMLHttpRequest.readyState Lecture seule

Retourne un nombre représentant l'état de la requête.

XMLHttpRequest.response Lecture seule

Retourne un objet ArrayBuffer, Blob, Document, un objet JavaScript ou une chaîne de caractères selon la valeur de