---
title: XMLHttpRequest.readyState
slug: Web/API/XMLHttpRequest/readyState
translation_of: Web/API/XMLHttpRequest/readyState
---
<p>{{APIRef('XMLHttpRequest')}}</p>

<p>La propriété XMLHttpRequest.readyState renvoie l'état dans lequel se trouve un client XMLHttpRequest.Un client <abbr title="XMLHttpRequest">XHR</abbr> existe dans l'un des états suivants :</p>

<table class="standard-table">
 <tbody>
  <tr>
   <td class="header">Value</td>
   <td class="header">State</td>
   <td class="header">Description</td>
  </tr>
  <tr>
   <td><code>0</code></td>
   <td><code>UNSENT</code></td>
   <td>Le client a été créé. open() n'a pas encore été appelé.</td>
  </tr>
  <tr>
   <td><code>1</code></td>
   <td><code>OPENED</code></td>
   <td><code>open()</code>a été appelé.</td>
  </tr>
  <tr>
   <td><code>2</code></td>
   <td><code>HEADERS_RECEIVED</code></td>
   <td><code>send()</code> a été appelé, et les en-têtes et le statut sont disponibles.</td>
  </tr>
  <tr>
   <td><code>3</code></td>
   <td><code>LOADING</code></td>
   <td>Téléchargement; <code>responseText</code> contient des données partielles.</td>
  </tr>
  <tr>
   <td><code>4</code></td>
   <td><code>DONE</code></td>
   <td>L'opération est terminée.</td>
  </tr>
 </tbody>
</table>

<dl>
 <dt>UNSENT</dt>
 <dd>Le client XMLHttpRequest a été créé, mais la méthode open() n'a pas encore été appelée.</dd>
 <dt>OPENED</dt>
 <dd>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 <a href="/en-US/docs/Web/API/XMLHttpRequest/setRequestHeader">setRequestHeader()</a>  et la méthode <a href="/en-US/docs/Web/API/XMLHttpRequest/send">send()</a>  peut être appelée, ce qui lancera la récupération.</dd>
 <dt>HEADERS_RECEIVED</dt>
 <dd>send() a été appelé et les en-têtes de réponse ont été reçus</dd>
 <dt>LOADING</dt>
 <dd>Le corps de la réponse est en cours de réception. Si <code><a href="/en-US/docs/Web/API/XMLHttpRequest/responseType">responseType</a></code> is "text"  ou une chaîne vide, <code><a href="/en-US/docs/Web/API/XMLHttpRequest/responseText">responseText</a></code> aura la réponse textuelle partielle au fur et à mesure de son chargement.</dd>
 <dt>DONE</dt>
 <dd>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é.</dd>
</dl>

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

<h2 id="Exemple">Exemple</h2>

<pre class="brush: js notranslate">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);
</pre>

<h2 id="Specifications">Specifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Statut</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('XMLHttpRequest', '#states')}}</td>
   <td>{{Spec2('XMLHttpRequest')}}</td>
   <td>WHATWG living standard</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>

<div class="hidden">Le tableau de compatibilité de cette page est généré à partir de données structurées. Si vous souhaitez contribuer à ces données, veuillez consulter le site https://github.com/mdn/browser-compat-data et nous envoyer une demande d'extraction.</div>

<p>{{Compat("api.XMLHttpRequest.readyState")}}</p>