Export (0) Print
Expand All
0 out of 1 rated this helpful - Rate this topic

readyState property

Retrieves the current state of the request operation.


HRESULT value = object.get_readyState(* p);

Property values

Type: long


The object has been created, but not initialized (the IHTMLXMLHttpRequest::open method has not been called).


A request has been opened, but the IHTMLXMLHttpRequest::send method has not been called.


The IHTMLXMLHttpRequest::send method has been called. No data is available yet.


Some data has been received; however, neither IHTMLXMLHttpRequest::responseText nor IHTMLXMLHttpRequest::responseBody is available.


All the data has been received.

Standards information


You cannot call IHTMLXMLHttpRequest::responseBody and IHTMLXMLHttpRequest::responseText properties to obtain partial results (IHTMLXMLHttpRequest::readyState = 3). Doing so will return an error, because the response is not fully received. You must wait until all data has been received.

In comparison, the Microsoft XML (MSXML) version of the IXMLHTTPRequest interface exposes partial results through the responseStream property, which the Windows Internet Explorer native version does not implement. Be aware that this behavior also differs from the IServerXMLHTTPRequest interface, which provides partial results to IHTMLXMLHttpRequest::responseBody and IHTMLXMLHttpRequest::responseText.

IHTMLXMLHttpRequest::readyState was introduced in Windows Internet Explorer 7.

See also




Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

© 2014 Microsoft. All rights reserved.