Les objetsXMLHttpRequest (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.

XMLHttpRequest est beaucoup utilisé par l'approcheAJAX.

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 à utiliserles évènements serveur via l'interfaceEventSource. Pour une communication bidirectionnelle complète, lesWebSockets peuvent être une meilleure alternative.

Constructeur

XMLHttpRequest()

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

Propriétés

Cette interface hérite également des propriétés deXMLHttpRequestEventTarget et deEventTarget.

XMLHttpRequest.onreadystatechange

Un gestionnaire d'évènement invoqué à chaque fois que l'attributreadyState change.

XMLHttpRequest.readyStateLecture seule

L'état de la requête sous la forme d'ununsigned short.

XMLHttpRequest.responseLecture seule

Un objetArrayBuffer,Blob,Document, un objet JavaScript ou une chaîne de caractères (DOMString) selon la valeur deXMLHttpRequest.responseType. Cet objet contient le corps de la réponse.

XMLHttpRequest.responseTextLecture seule

Une chaîne de caractèresDOMString qui contient la réponse à la requête sous forme de texte ou la valeurnull si la requête a échoué ou n'a pas encore été envoyée.

XMLHttpRequest.responseType

Une valeur parmi une liste qui définit le type de réponse.

XMLHttpRequest.responseURLLecture seule

L'URL sérialisée de la réponse ou la chaîne vide si l'URL est nulle.

XMLHttpRequest.responseXMLLecture seule

Un objetDocument qui contient la réponse de la requête ounull si la requête a échoué, qu'elle n'a pas encore été envoyée ou qu'elle ne peut pas être analysée comme XML ou HTML. Cette propriété n'est pas disponible dans lesworkers.

XMLHttpRequest.statusLecture seule

Une valeur numériqueunsigned short qui décrit le statut de la réponse à la requête.

XMLHttpRequest.statusTextLecture seule

Une chaîneDOMString qui contient la chaîne de caractères / réponse renvoyée par le serveur HTTP. À la différence deXMLHttpRequest.status, tout le texte du statut est inclus ("200 OK" plutôt que "200" par exemple).

XMLHttpRequest.timeout

Un entierunsigned long qui représente le nombre de millisecondes qu'une requête peut prendre avant d'être terminée automatiquement.

XMLHttpRequestEventTarget.ontimeout

Un gestionnaire d'évènement appelé lorsque la requête a expiré.

XMLHttpRequest.uploadLecture seule

Un objetXMLHttpRequestUpload qui représente le processus d'upload.

XMLHttpRequest.withCredentials

Un booléen (Boolean) qui indique si des requêtesAccess-Control d'origines différentes peuvent être effectuées avec des informations d'authentification telles que des cookies ou des en-têtes d'autorisation.

Propriétés non-standard

XMLHttpRequest.channelLecture seule

Un objetnsIChannel. Le canal à utiliser par l'objet lorsqu'il effectue la requête.

XMLHttpRequest.mozAnonLecture seule

Un booléen. S'il est vrai, la requête sera envoyée sans cookie ou en-tête d'autorisation.

XMLHttpRequest.mozSystemLecture seule

Un booléen. S'il est vrai, la politique d'origine unique ne sera pas vérifiée pour la requête.

XMLHttpRequest.mozBackgroundRequest

Un booléen qui indique si l'objet représente une requête de service en arrière-plan.

XMLHttpRequest.mozResponseArrayBufferObsolèteLecture seule

Un objetArrayBuffer qui est la réponse à la requête sous la forme d'un tableau typé JavaScript.

XMLHttpRequest.multipartObsolète

Cette fonctionnalité spécifique à Gecko a été retirée avec Firefox/Gecko 22. Veuillez utiliserles évènements serveurs oules web sockets ou encore la propriétéresponseText des évènements de progression.

Gestionnaires d'évènement

Le gestionnaireonreadystatechange, comme propriété des instancesXMLHttpRequest, est pris en charge par l'ensemble des navigateurs.

D'autres gestionnaires d'évènements ont également été implémentés dans différents navigateurs (onload,onerror,onprogress, etc.). Voir le guideManipuler XMLHttpRequest.

La plupart des navigateurs récents gère également les évènements via la méthodeaddEventListener() (en plus des méthodeson*).

Méthodes

XMLHttpRequest.abort()

Interrompt la requête si elle a déjà été envoyée.

XMLHttpRequest.getAllResponseHeaders()

Renvoie, via une chaîne de caractères, l'ensemble des en-têtes de la réponse, séparés parCRLF ou la valeurnull si aucune réponse n'a été reçue.

XMLHttpRequest.getResponseHeader()

Renvoie la chaîne de caractères contenant le texte de l'en-tête voulue ounull si aucune des réponse n'a été reçue ou si l'en-tête n'existe pas dans la réponse.

XMLHttpRequest.open()

Initialise une requête. Cette méthode doit être utilisée par du code JavaScript.

XMLHttpRequest.overrideMimeType()

Surcharge le type MIME renvoyé par le serveur.

XMLHttpRequest.send()

Envoie la requête. Si la requête est asynchrone (le comportement par défaut), la méthode renvoie un résultat dès que la requête est envoyée.

XMLHttpRequest.setRequestHeader()

Définit la valeur d'un en-tête de requête HTTP. Cette méthode doit être appelée aprèsopen() mais avantsend().

Méthodes non-standard

XMLHttpRequest.init()

Initialise l'objet depuis pour une utilisation depuis du code C++.

XMLHttpRequest.openRequest()

Initialise une requête depuis du code natif. Voir la méthodeopen() ci-avant pour initialiser une requête de façon standard en JavaSCript.

XMLHttpRequest.sendAsBinary()Obsolète

Une variante desend() afin d'envoyer des données binaires.

Évènements

abort

Se déclenche lorsqu'une requête a été interrompue (par exemple viaXMLHttpRequest.abort()). Le gestionnaireonabort est également disponible.

error

Se déclenche lorsqu'une requête a rencontré une erreur.Le gestionnaireonerror est également disponible.

load

Se déclenche lorsqu'une transactionXMLHttpRequest se termine correctement. Le gestionnaireonload est également disponible.

loadend

Se déclenche lorsqu'une requête est terminée (avec une erreur ou non). Quand elle a réussi, l'évènement a lieu aprèsload). Quand elle a échoué, l'évènement survient aprèserror).Le gestionnaireonloadend est également disponible.

loadstart

Se déclenche lorsqu'une requête commence à charger des données.Le gestionnaireonloadstart est également disponible.

progress

Se déclenche périodiquement lorsqu'une requête reçoit des données supplémentaires. Le gestionnaireonprogress est également disponible.

timeout

Se déclenche lorsque la progression est terminée du fait de l'expiration de la durée limite. Le gestionnaireontimeout est également disponible.

Spécifications

Compatibilité des navigateurs

Voir aussi

• XMLSerializer : sérialiser un arbre DOM en XML

• Les tutoriels MDN surXMLHttpRequest:

  • Introduction à AJAX
  • Utiliser XMLHttpRequest
  • Manipuler le HTML avec XMLHttpRequest
  • L'API Fetch

• HTML5 Rocks — Nouvelles astuces avec XMLHttpRequest2 (en anglais)