readyState Property (IXMLHTTPRequest)

Represents the state of the request.

Example

var XmlHttp;
XmlHttp = new ActiveXObject("Msxml2.XMLHTTP.5.0");

function send() {
   XmlHttp.onreadystatechange = doHttpReadyStateChange;
   XmlHttp.open("GET", "http://localhost/sample.xml", true);
   XmlHttp.send();
}

function doHttpReadyStateChange() {
   if (XmlHttp.readyState == 4) {
      alert("Done");
   }
}

[Script]

Script Syntax

lValue = oXMLHttpRequest.readyState;

[Visual Basic]

Visual Basic Syntax

lValue = oXMLHttpRequest.readyState

[C/C++]

C/C++ Syntax

HRESULT get_readyState(long* plState);

Parameters

plState [out, retval]

State of the request, as an I4 (4-byte integer). The following values are defined:

(0) UNINITIALIZED	The object has been created, but not initialized (`open` has not been called).
(1) LOADING	The object has been created, but the `send` method has not been called.
(2) LOADED	The `send` method has been called and the status and headers are available, but the response is not yet available.
(3) INTERACTIVE	Some data has been received. You can call the `responseBody` and `responseText` properties to get the current partial results.
(4) COMPLETED	All the data has been received, and the complete data is available in the `responseBody` and `responseText` properties.

C/C++ Return Values

S_OK: Value returned if successful.

Remarks

Variant. The property is read-only. It represents the state of the request as an I4 (4-byte integer). The following values are defined.

0 (UNINITIALIZED)	The object has been created, but not initialized (the `open` method has not been called).
(1) LOADING	The object has been created, but the `send` method has not been called.
(2) LOADED	The `send` method has been called and the status and headers are available, but the response is not yet available.
(3) INTERACTIVE	Some data has been received. You can call the `responseBody` and `responseText` properties to get the current partial results.
(4) COMPLETED	All the data has been received, and the complete data is available in the `responseBody` and `responseText` properties.

This property returns a 4-byte integer.

To view reference information for Visual Basic, C/C++, or Script only, click the Language Filter button in the upper-left corner of the page.