XMLHttpRequest.readyState

Cette traduction est incomplète. Aidez-nous à traduire cet article depuis l’anglais

La propriété XMLHttpRequest.readyState renvoie l'état dans lequel se trouve un client XMLHttpRequest.Un client XHR existe dans l'un des états suivants :

Value State Description
0 UNSENT Le client a été créé. open() n'a pas encore été appelé.
1 OPENED open()a été appelé.
2 HEADERS_RECEIVED send() a été appelé, et les en-têtes et le statut sont disponibles.
3 LOADING Téléchargement; responseText contient des données partielles.
4 DONE L'opération est terminée.
UNSENT
Le client XMLHttpRequest a été créé, mais la méthode open() n'a pas encore été appelée.
OPENED
La méthode open() a été invoquée. Pendant cet état, les en-têtes de requête peuvent être définis à l'aide de la méthode setRequestHeader()  et la méthode send()  peut être appelée, ce qui lancera la récupération.
HEADERS_RECEIVED
send() a été appelé et les en-têtes de réponse ont été reçus
LOADING
Le corps de la réponse est en cours de réception. Si responseType is "text"  ou une chaîne vide, responseText aura la réponse textuelle partielle au fur et à mesure de son chargement.
DONE
L'opération de récupération est terminée. Cela peut signifier que le transfert de données a été effectué avec succès ou a échoué.

Les noms des États sont différents dans les versions d'Internet Explorer antérieures à 11. Au lieu de UNSENT, OPENED, HEADERS_RECEIVED, LOADING and DONE, the names READYSTATE_UNINITIALIZED (0), READYSTATE_LOADING (1), READYSTATE_LOADED (2), READYSTATE_INTERACTIVE (3) et READYSTATE_COMPLETE (4) sont utilisés.

Exemple

var xhr = new XMLHttpRequest();
console.log('UNSENT', xhr.readyState); // readyState will be 0

xhr.open('GET', '/api', true);
console.log('OPENED', xhr.readyState); // readyState will be 1

xhr.onprogress = function () {
    console.log('LOADING', xhr.readyState); // readyState will be 3
};

xhr.onload = function () {
    console.log('DONE', xhr.readyState); // readyState will be 4
};

xhr.send(null);

Specifications

Specification Statut Comment
XMLHttpRequest Standard évolutif WHATWG living standard

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
readyStateChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 7Opera Support complet 8Safari Support complet 1.2WebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet 10.1Safari iOS Support complet 1Samsung Internet Android Support complet 1.0
constantsChrome Support complet OuiEdge Support complet 12Firefox Support complet 9IE Support complet 9Opera Support complet 12Safari Support complet OuiWebView Android Support complet OuiChrome Android Support complet 18Firefox Android Support complet 9Opera Android Support complet OuiSafari iOS ? Samsung Internet Android Support complet 1.0

Légende

Support complet  
Support complet
Compatibilité inconnue  
Compatibilité inconnue