Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

Revision 1065146 of XMLHttpRequest

  • Revision slug: Web/API/XMLHttpRequest
  • Revision title: XMLHttpRequest
  • Revision id: 1065146
  • Created:
  • Creator: MashKao
  • Is current revision? No
  • Comment

Revision Content

{{APIRef("XMLHttpRequest")}}

XMLHttpRequest is an API that provides client functionality for transferring data between a client and a server. It provides an easy way to retrieve data from a URL without having to do a full page refresh. This enables a Web page to update just a part of the page without disrupting what the user is doing.  XMLHttpRequest is used heavily in AJAX programming.

XMLHttpRequest was originally designed by Microsoft and adopted by Mozilla, Apple, and Google. It's now being standardized at the WHATWG. Despite its name, XMLHttpRequest can be used to retrieve any type of data, not just XML, and it supports protocols other than HTTP (including file and ftp).

Constructor

{{domxref("XMLHttpRequest.XMLHttpRequest", "XMLHttpRequest")}}
The constructor initiates an XMLHttpRequest. It must be called before any other method calls.

Properties

This interface also inherits properties of {{domxref("XMLHttpRequestEventTarget")}} and of {{domxref("EventTarget")}}.

{{domxref("XMLHttpRequest.onreadystatechange")}}
An {{domxref("EventHandler")}} that is called whenever the readyState attribute changes.
{{domxref("XMLHttpRequest.readyState")}} {{readonlyinline}}
Returns an unsigned short, the state of the request.
{{domxref("XMLHttpRequest.response")}} {{readonlyinline}}
Returns an {{domxref("ArrayBuffer")}}, {{domxref("Blob")}}, {{domxref("Document")}}, JavaScript object, or a {{domxref("DOMString")}}, depending of the value of {{domxref("XMLHttpRequest.responseType")}}. that contains the response entity body.
{{domxref("XMLHttpRequest.responseText")}} {{readonlyinline}}
Returns a {{domxref("DOMString")}} that contains the response to the request as text, or null if the request was unsuccessful or has not yet been sent.
{{domxref("XMLHttpRequest.responseType")}}
Is an enumerated value that defines the response type.
{{domxref("XMLHttpRequest.responseURL")}} {{readonlyinline}}
Returns the serialized URL of the response or the empty string if the URL is null.
{{domxref("XMLHttpRequest.responseXML")}} {{readonlyinline}} {{NotAvailableInWorkerInline}}
Returns a {{domxref("Document")}} containing the response to the request, or null if the request was unsuccessful, has not yet been sent, or cannot be parsed as XML or HTML.
{{domxref("XMLHttpRequest.status")}} {{readonlyinline}}
Returns an unsigned short with the status of the response of the request.
{{domxref("XMLHttpRequest.statusText")}} {{readonlyinline}}
Returns a {{domxref("DOMString")}} containing the response string returned by the HTTP server. Unlike {{domxref("XMLHTTPRequest.status")}}, this includes the entire text of the response message ("200 OK", for example).
{{domxref("XMLHttpRequest.timeout")}}
Is an unsigned long representing the number of milliseconds a request can take before automatically being terminated.
{{domxref("XMLHttpRequestEventTarget.ontimeout")}}
Is an {{domxref("EventHandler")}} that is called whenever the request times out. {{gecko_minversion_inline("12.0")}}
{{domxref("XMLHttpRequest.upload")}} {{readonlyinline}}
Is an {{domxref("XMLHttpRequestUpload")}}, representing the upload process.
{{domxref("XMLHttpRequest.withCredentials")}}
Is a {{jsxref("Boolean")}} that indicates whether or not cross-site Access-Control requests should be made using credentials such as cookies or authorization headers.

Non-standard properties

{{domxref("XMLHttpRequest.channel")}}{{ReadOnlyInline}}
Is a {{Interface("nsIChannel")}}. The channelused by the  object when performing the request.
{{domxref("XMLHttpRequest.mozAnon")}}{{ReadOnlyInline}}
Is a boolean. If true, the request will be sent without cookie and authentication headers.
{{domxref("XMLHttpRequest.mozSystem")}}{{ReadOnlyInline}}
Is a boolean. If true, the same origin policy will not be enforced on the request.
{{domxref("XMLHttpRequest.mozBackgroundRequest")}}
Is a boolean. It indicates whether or not the object represents a background service request.
{{domxref("XMLHttpRequest.mozResponseArrayBuffer")}}{{gecko_minversion_inline("2.0")}} {{obsolete_inline("6")}} {{ReadOnlyInline}}
Is an ArrayBuffer. The response to the request, as a JavaScript typed array.
{{domxref("XMLHttpRequest.multipart")}}{{obsolete_inline("22")}}
This Gecko-only feature, a boolean, was removed in Firefox/Gecko 22. Please use Server-Sent Events, Web Sockets, or responseText from progress events instead.

Methods

{{domxref("XMLHttpRequest.abort")}}
Aborts the request if it has already been sent.
{{domxref("XMLHttpRequest.getAllResponseHeaders")}}
Returns all the response headers, separated by CRLF, as a string, or null if no response has been received.
{{domxref("XMLHttpRequest.getResponseHeader")}}
Returns the string containing the text of the specified header, or null if either the response has not yet been received or the header doesn't exist in the response.
{{domxref("XMLHttpRequest.open")}}
Initializes a request. This method is to be used from JavaScript code; to initialize a request from native code, use openRequest() instead.
{{domxref("XMLHttpRequest.overrideMimeType")}}
Overrides the MIME type returned by the server.
{{domxref("XMLHttpRequest.send")}}
Sends the request. If the request is asynchronous (which is the default), this method returns as soon as the request is sent.
{{domxref("XMLHttpRequest.setRequestHeader")}}
Sets the value of an HTTP request header. You must call setRequestHeader()after open(), but before send().

Non-standard methods

{{domxref("XMLHttpRequest.init")}}
Initializes the object for use from C++ code.
Warning: This method must not be called from JavaScript.
{{domxref("XMLHttpRequest.openRequest")}}
Initializes a request. This method is to be used from native code; to initialize a request from JavaScript code, use open()instead. See the documentation for open().
{{domxref("XMLHttpRequest.sendAsBinary")}}{{deprecated_inline(31)}}
A variant of the send() method that sends binary data.

Events

onreadystatechange as a property of the XMLHttpRequest instance is supported in all browsers.

Since then, a number of additional event handlers were implemented in various browsers (onload, onerror, onprogress, etc.). These are supported in Firefox. In particular, see {{interface("nsIXMLHttpRequestEventTarget")}} and Using XMLHttpRequest.

More recent browsers, including Firefox, also support listening to the XMLHttpRequest events via standard addEventListener APIs in addition to setting on* properties to a handler function.

Specifications

Specification Status Comment
{{SpecName('XMLHttpRequest')}} {{Spec2('XMLHttpRequest')}} WHATWG living standard

Browser compatibility

{{CompatibilityTable}}

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support (XHR1) 1 {{CompatGeckoDesktop("1.0")}}[1] 5[2]
7
{{CompatVersionUnknown}} 1.2
send(ArrayBuffer) 9 {{CompatGeckoDesktop("9.0")}} 10 11.60 {{compatUnknown}}
send(ArrayBufferView) 22 {{CompatGeckoDesktop("20.0")}} {{compatUnknown}} {{compatUnknown}} {{compatUnknown}}
send(Blob) 7 {{CompatGeckoDesktop("1.9.2")}} 10 12 {{compatUnknown}}
send(FormData) 6 {{CompatGeckoDesktop("2.0")}} 10 12 {{compatUnknown}}
sendAsBinary(DOMString) {{non-standard_inline}} {{deprecated_inline}} {{compatNo}}[3] {{CompatGeckoDesktop("1.8.1")}} {{CompatNo}} {{CompatNo}} {{CompatNo}}
response 10 {{CompatGeckoDesktop("6.0")}} 10 11.60 {{CompatVersionUnknown}}
responseType = 'arraybuffer' 10 {{CompatGeckoDesktop("6.0")}} 10 11.60 {{CompatVersionUnknown}}
responseType = 'blob' 19 {{CompatGeckoDesktop("6.0")}} 10 12 {{CompatVersionUnknown}}
responseType = 'document' 18 {{CompatGeckoDesktop("11.0")}} 10 {{CompatNo}} 6.1
responseType = 'json' 31 {{CompatGeckoDesktop("10.0")}} {{CompatNo}} 12[4]
{{CompatNo}} 16
17
{{CompatVersionUnknown}}
Progress Events 7 {{CompatGeckoDesktop("1.9.1")}} 10 12 {{CompatVersionUnknown}}
withCredentials 3 {{CompatGeckoDesktop("1.9.1")}} 10 12 4
timeout 29.0[5] {{CompatGeckoDesktop("12.0")}} 8 12[6]
16
{{CompatVersionUnknown}}
responseType = 'moz-blob' {{CompatNo}} {{CompatGeckoDesktop("12.0")}} {{CompatNo}} {{CompatNo}} {{CompatNo}}
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support {{CompatUnknown}} 1.0 {{CompatVersionUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}}
send(ArrayBuffer) {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{compatUnknown}}
send(ArrayBufferView) {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{compatUnknown}}
send(Blob) {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{compatUnknown}}
send(FormData) {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{compatUnknown}}
sendAsBinary(DOMString) {{non-standard_inline}} {{deprecated_inline}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{compatUnknown}}
response {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{compatUnknown}}
responseType = 'arraybuffer' {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{compatUnknown}}
responseType = 'blob' {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{compatUnknown}}
responseType = 'document' {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{compatUnknown}}
responseType = 'json' {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{compatUnknown}}
Progress Events {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{compatUnknown}}
withCredentials {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{compatUnknown}}
timeout {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{compatUnknown}}
responseType = 'moz-blob' {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{compatUnknown}}

[1] Gecko 11.0 {{geckoRelease("11.0")}} removed support for using the responseType and withCredentials attributes when performing synchronous requests. Attempting to do so throws an NS_ERROR_DOM_INVALID_ACCESS_ERR exception. This change has been proposed to the W3C for standardization.

Gecko 12.0 {{geckoRelease("12.0")}} and later support using XMLHttpRequest to read from data: URLs.

Gecko 20.0 {{geckoRelease("20.0")}} adds the support of sending an ArrayBufferView - sending a plain ArrayBuffer is not part of the XMLHttpRequest specification any longer and should be treated as deprecated.

[2] This feature was implemented via ActiveXObject(). Since version 7 Internet Explorer implements the standard XMLHttpRequest.

[3] There is a polyfill available to support sendAsBinary().

[4] Before switching to Blink/Chromium Opera supported responseType=json between Opera 12 and Opera 15. Support is added again after it is implemented also in Blink (Opera 17).

[5] This feature was implemented in bug 231959.

[6] See how to set and handle timeouts.

See also

Revision Source

<div>{{APIRef("XMLHttpRequest")}}</div>

<p><span class="seoSummary"><code>XMLHttpRequest</code> is an&nbsp;API that provides client functionality for transferring data between a client and a server. It provides an easy way to retrieve data from a URL without having to do a full page refresh. This enables a Web page to update just a part of the page without disrupting what the user is doing.</span> &nbsp;<code>XMLHttpRequest</code>&nbsp;is used heavily in <a href="/en-US/docs/AJAX">AJAX</a> programming.</p>

<p>XMLHttpRequest was originally designed by Microsoft and adopted by Mozilla, Apple, and Google. It's now being <a class="external" href="https://xhr.spec.whatwg.org/">standardized at the <abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr></a>. Despite its name, <code>XMLHttpRequest</code> can be used to retrieve any type of data, not just XML, and it supports protocols other than <a href="/en-US/docs/Web/HTTP">HTTP</a> (including <code>file</code> and <code>ftp</code>).</p>

<h2 id="Constructor">Constructor</h2>

<dl>
 <dt>{{domxref("XMLHttpRequest.XMLHttpRequest", "XMLHttpRequest")}}</dt>
 <dd>The constructor initiates an XMLHttpRequest. It must be called before any other method calls.</dd>
</dl>

<h2 id="Properties">Properties</h2>

<p><em>This interface also inherits properties of {{domxref("XMLHttpRequestEventTarget")}} and of {{domxref("EventTarget")}}.</em></p>

<dl>
 <dt id="xmlhttprequest-onreadystatechange">{{domxref("XMLHttpRequest.onreadystatechange")}}</dt>
 <dd>An {{domxref("EventHandler")}} that is called whenever the <code>readyState</code> attribute changes.</dd>
 <dt id="xmlhttprequest-readystate">{{domxref("XMLHttpRequest.readyState")}} {{readonlyinline}}</dt>
 <dd>Returns an <code>unsigned short</code>, the state of the request.</dd>
 <dt>{{domxref("XMLHttpRequest.response")}} {{readonlyinline}}</dt>
 <dd>Returns an {{domxref("ArrayBuffer")}}, {{domxref("Blob")}}, {{domxref("Document")}}, JavaScript object, or a {{domxref("DOMString")}}, depending of the value of {{domxref("XMLHttpRequest.responseType")}}. that contains the response entity body.</dd>
 <dt id="xmlhttprequest-responsetext">{{domxref("XMLHttpRequest.responseText")}} {{readonlyinline}}</dt>
 <dd>Returns a {{domxref("DOMString")}} that contains the response to the request as text, or <code>null</code> if the request was unsuccessful or has not yet been sent.</dd>
 <dt id="xmlhttprequest-responsetype">{{domxref("XMLHttpRequest.responseType")}}</dt>
 <dd>Is an enumerated value that defines the response type.</dd>
 <dt id="xmlhttprequest-responsexml">{{domxref("XMLHttpRequest.responseURL")}} {{readonlyinline}}</dt>
 <dd>Returns the serialized URL of the response or the empty string if the URL is null.</dd>
 <dt id="xmlhttprequest-responsexml">{{domxref("XMLHttpRequest.responseXML")}} {{readonlyinline}} {{NotAvailableInWorkerInline}}</dt>
 <dd>Returns a {{domxref("Document")}} containing the response to the request, or <code>null</code> if the request was unsuccessful, has not yet been sent, or cannot be parsed as XML or HTML.</dd>
 <dt id="xmlhttprequest-status">{{domxref("XMLHttpRequest.status")}} {{readonlyinline}}</dt>
 <dd>Returns an <code>unsigned short</code> with the status of the response of the request.</dd>
 <dt id="xmlhttprequest-statustext">{{domxref("XMLHttpRequest.statusText")}} {{readonlyinline}}</dt>
 <dd>Returns a {{domxref("DOMString")}} containing the response string returned by the HTTP server. Unlike {{domxref("XMLHTTPRequest.status")}}, this includes the entire text of the response message ("<code>200 OK</code>", for example).</dd>
 <dt id="xmlhttprequest-timeout">{{domxref("XMLHttpRequest.timeout")}}</dt>
 <dd>Is an <code>unsigned long</code> representing the number of milliseconds a request can take before automatically being terminated.</dd>
 <dt id="xmlhttprequesteventtarget-ontimeout">{{domxref("XMLHttpRequestEventTarget.ontimeout")}}</dt>
 <dd>Is an {{domxref("EventHandler")}} that is called whenever the request times out. {{gecko_minversion_inline("12.0")}}</dd>
 <dt id="xmlhttprequest-upload">{{domxref("XMLHttpRequest.upload")}} {{readonlyinline}}</dt>
 <dd>Is an {{domxref("XMLHttpRequestUpload")}}, representing the upload process.</dd>
 <dt id="xmlhttprequest-withcredentials">{{domxref("XMLHttpRequest.withCredentials")}}</dt>
 <dd>Is a {{jsxref("Boolean")}} that indicates whether or not cross-site <code>Access-Control</code> requests should be made using credentials such as cookies or authorization headers.</dd>
</dl>

<h3 id="Non-standard_properties">Non-standard properties</h3>

<dl>
 <dt>{{domxref("XMLHttpRequest.channel")}}{{ReadOnlyInline}}</dt>
 <dd>Is a {{Interface("nsIChannel")}}. The channelused by the&nbsp; object when performing the request.</dd>
 <dt>{{domxref("XMLHttpRequest.mozAnon")}}{{ReadOnlyInline}}</dt>
 <dd>Is a boolean. If true, the request will be sent without cookie and authentication headers.</dd>
 <dt>{{domxref("XMLHttpRequest.mozSystem")}}{{ReadOnlyInline}}</dt>
 <dd>Is a boolean. If true, the same origin policy will not be enforced on the request.</dd>
 <dt>{{domxref("XMLHttpRequest.mozBackgroundRequest")}}</dt>
 <dd>Is a boolean. It indicates whether or not the object represents a background service request.</dd>
 <dt>{{domxref("XMLHttpRequest.mozResponseArrayBuffer")}}{{gecko_minversion_inline("2.0")}} {{obsolete_inline("6")}} {{ReadOnlyInline}}</dt>
 <dd>Is an <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer"><code>ArrayBuffer</code></a>. The response to the request, as a JavaScript typed array.</dd>
 <dt>{{domxref("XMLHttpRequest.multipart")}}{{obsolete_inline("22")}}</dt>
 <dd><strong>This Gecko-only feature, a boolean, was removed in Firefox/Gecko 22.</strong> Please use <a href="/en-US/docs/Web/API/Server-sent_events">Server-Sent Events</a>, <a href="/en-US/docs/Web/API/WebSockets_API">Web Sockets</a>, or <code>responseText</code> from progress events instead.</dd>
</dl>

<dl>
</dl>

<h2 id="Methods">Methods</h2>

<dl>
 <dt>{{domxref("XMLHttpRequest.abort")}}</dt>
 <dd>Aborts the request if it has already been sent.</dd>
 <dt>{{domxref("XMLHttpRequest.getAllResponseHeaders")}}</dt>
 <dd>Returns all the response headers, separated by <a href="https://developer.mozilla.org/en-US/docs/Glossary/CRLF">CRLF</a>, as a string, or <code>null</code> if no response has been received.<strong> </strong></dd>
 <dt>{{domxref("XMLHttpRequest.getResponseHeader")}}</dt>
 <dd>Returns the string containing the text of the specified header, or <code>null</code> if either the response has not yet been received or the header doesn't exist in the response.</dd>
 <dt>{{domxref("XMLHttpRequest.open")}}</dt>
 <dd>Initializes a request. This method is to be used from JavaScript code; to initialize a request from native code, use <a class="internal" href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIXMLHttpRequest#openRequest()"><code>openRequest()</code></a> instead.</dd>
 <dt>{{domxref("XMLHttpRequest.overrideMimeType")}}</dt>
 <dd>Overrides the MIME type returned by the server.</dd>
 <dt>{{domxref("XMLHttpRequest.send")}}<span style="display:none"> </span></dt>
 <dd>Sends the request. If the request is asynchronous (which is the default), this method returns as soon as the request is sent.</dd>
 <dt>{{domxref("XMLHttpRequest.setRequestHeader")}}</dt>
 <dd>Sets the value of an HTTP request header. You must call <code>setRequestHeader()</code>after&nbsp;<a href="#open"><code>open()</code></a>, but before <code>send()</code>.</dd>
</dl>

<h3 id="Non-standard_methods">Non-standard methods</h3>

<dl>
 <dt>{{domxref("XMLHttpRequest.init")}}</dt>
 <dd>Initializes the object for use from C++ code.</dd>
</dl>

<div class="warning"><strong>Warning:</strong> This method must <em>not</em> be called from JavaScript.</div>

<dl>
 <dt>{{domxref("XMLHttpRequest.openRequest")}}</dt>
 <dd>Initializes a request. This method is to be used from native code; to initialize a request from JavaScript code, use <a class="internal" href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIXMLHttpRequest#open()"><code>open()</code></a>instead. See the documentation for <code>open()</code>.</dd>
 <dt>{{domxref("XMLHttpRequest.sendAsBinary")}}{{deprecated_inline(31)}}</dt>
 <dd>A variant of the <code>send()</code> method that sends binary data.</dd>
</dl>

<h2>Events</h2>

<p><code>onreadystatechange</code> as a property of the <code>XMLHttpRequest</code> instance is supported in all browsers.</p>

<p>Since then, a number of additional event handlers were implemented in various browsers (<code>onload</code>, <code>onerror</code>, <code>onprogress</code>, etc.). These are supported in Firefox. In particular, see {{interface("nsIXMLHttpRequestEventTarget")}} and <a href="/en-US/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest">Using XMLHttpRequest</a>.</p>

<p>More recent browsers, including Firefox, also support listening to the <code>XMLHttpRequest</code> events via standard <code><a href="/en-US/docs/Web/API/EventTarget/addEventListener">addEventListener</a></code> APIs in addition to setting <code>on*</code> properties to a handler function.</p>

<h2>Specifications</h2>

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

<h2 id="Browser_compatibility">Browser compatibility</h2>

<p>{{CompatibilityTable}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>Basic support (XHR1)</td>
   <td>1</td>
   <td>{{CompatGeckoDesktop("1.0")}}<sup>[1]</sup></td>
   <td>5<sup>[2]</sup><br />
    7</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>1.2</td>
  </tr>
  <tr>
   <td><code>send(ArrayBuffer)</code></td>
   <td>9</td>
   <td>{{CompatGeckoDesktop("9.0")}}</td>
   <td>10</td>
   <td>11.60</td>
   <td>{{compatUnknown}}</td>
  </tr>
  <tr>
   <td><code>send(ArrayBufferView)</code></td>
   <td>22</td>
   <td>{{CompatGeckoDesktop("20.0")}}</td>
   <td>{{compatUnknown}}</td>
   <td>{{compatUnknown}}</td>
   <td>{{compatUnknown}}</td>
  </tr>
  <tr>
   <td><code>send(Blob)</code></td>
   <td>7</td>
   <td>{{CompatGeckoDesktop("1.9.2")}}</td>
   <td>10</td>
   <td>12</td>
   <td>{{compatUnknown}}</td>
  </tr>
  <tr>
   <td><code>send(FormData)</code></td>
   <td>6</td>
   <td>{{CompatGeckoDesktop("2.0")}}</td>
   <td>10</td>
   <td>12</td>
   <td>{{compatUnknown}}</td>
  </tr>
  <tr>
   <td><code>sendAsBinary(DOMString)</code> {{non-standard_inline}} {{deprecated_inline}}</td>
   <td>{{compatNo}}<sup>[3]</sup></td>
   <td>{{CompatGeckoDesktop("1.8.1")}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
  <tr>
   <td><code>response</code></td>
   <td>10</td>
   <td>{{CompatGeckoDesktop("6.0")}}</td>
   <td>10</td>
   <td>11.60</td>
   <td>{{CompatVersionUnknown}}</td>
  </tr>
  <tr>
   <td><code>responseType</code> = 'arraybuffer'</td>
   <td>10</td>
   <td>{{CompatGeckoDesktop("6.0")}}</td>
   <td>10</td>
   <td>11.60</td>
   <td>{{CompatVersionUnknown}}</td>
  </tr>
  <tr>
   <td><code>responseType</code> = 'blob'</td>
   <td>19</td>
   <td>{{CompatGeckoDesktop("6.0")}}</td>
   <td>10</td>
   <td>12</td>
   <td>{{CompatVersionUnknown}}</td>
  </tr>
  <tr>
   <td><code>responseType</code> = 'document'</td>
   <td>18</td>
   <td>{{CompatGeckoDesktop("11.0")}}</td>
   <td>10</td>
   <td>{{CompatNo}}</td>
   <td>6.1</td>
  </tr>
  <tr>
   <td><code>responseType</code> = 'json'</td>
   <td>31</td>
   <td>{{CompatGeckoDesktop("10.0")}}</td>
   <td>{{CompatNo}}</td>
   <td>12<sup>[4]</sup><br />
    {{CompatNo}} 16<br />
    17</td>
   <td>{{CompatVersionUnknown}}</td>
  </tr>
  <tr>
   <td>Progress Events</td>
   <td>7</td>
   <td>{{CompatGeckoDesktop("1.9.1")}}</td>
   <td>10</td>
   <td>12</td>
   <td>{{CompatVersionUnknown}}</td>
  </tr>
  <tr>
   <td><code>withCredentials</code></td>
   <td>3</td>
   <td>{{CompatGeckoDesktop("1.9.1")}}</td>
   <td>10</td>
   <td>12</td>
   <td>4</td>
  </tr>
  <tr>
   <td><code>timeout</code></td>
   <td>29.0<sup>[5]</sup></td>
   <td>{{CompatGeckoDesktop("12.0")}}</td>
   <td>8</td>
   <td>12<sup>[6]</sup><br />
    16</td>
   <td>{{CompatVersionUnknown}}</td>
  </tr>
  <tr>
   <td><code>responseType</code> = 'moz-blob'</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatGeckoDesktop("12.0")}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Chrome for Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Phone</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatUnknown}}</td>
   <td>1.0</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td><code>send(ArrayBuffer)</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{compatUnknown}}</td>
  </tr>
  <tr>
   <td><code>send(ArrayBufferView)</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{compatUnknown}}</td>
  </tr>
  <tr>
   <td><code>send(Blob)</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{compatUnknown}}</td>
  </tr>
  <tr>
   <td><code>send(FormData)</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{compatUnknown}}</td>
  </tr>
  <tr>
   <td><code>sendAsBinary(DOMString)</code> {{non-standard_inline}} {{deprecated_inline}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{compatUnknown}}</td>
  </tr>
  <tr>
   <td><code>response</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{compatUnknown}}</td>
  </tr>
  <tr>
   <td><code>responseType</code> = 'arraybuffer'</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{compatUnknown}}</td>
  </tr>
  <tr>
   <td><code>responseType</code> = 'blob'</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{compatUnknown}}</td>
  </tr>
  <tr>
   <td><code>responseType</code> = 'document'</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{compatUnknown}}</td>
  </tr>
  <tr>
   <td><code>responseType</code> = 'json'</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{compatUnknown}}</td>
  </tr>
  <tr>
   <td>Progress Events</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{compatUnknown}}</td>
  </tr>
  <tr>
   <td><code>withCredentials</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{compatUnknown}}</td>
  </tr>
  <tr>
   <td><code>timeout</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{compatUnknown}}</td>
  </tr>
  <tr>
   <td><code>responseType</code> = 'moz-blob'</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{compatUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] Gecko 11.0 {{geckoRelease("11.0")}} removed support for using the <code>responseType</code> and <code>withCredentials</code> attributes when performing synchronous requests. Attempting to do so throws an <code>NS_ERROR_DOM_INVALID_ACCESS_ERR</code> exception. This change has been proposed to the W3C for standardization.</p>

<p>Gecko 12.0 {{geckoRelease("12.0")}} and later support using <code>XMLHttpRequest</code> to read from <a href="/en-US/docs/Web/HTTP/data_URIs"><code>data:</code> URLs</a>.</p>

<p>Gecko 20.0 {{geckoRelease("20.0")}} adds the support of sending an <a href="/en-US/docs/Web/API/ArrayBufferView"><code>ArrayBufferView</code></a> - sending a plain <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer"><code>ArrayBuffer</code></a> is not part of the <code>XMLHttpRequest</code> specification any longer and should be treated as deprecated.</p>

<p>[2] This feature was implemented via <code>ActiveXObject()</code>. Since version 7 Internet Explorer implements the standard <code>XMLHttpRequest</code>.</p>

<p>[3] There is a <a href="#sendAsBinary%28%29_polyfill">polyfill</a> available to support <code>sendAsBinary()</code>.</p>

<p>[4] Before switching to Blink/Chromium Opera supported <code>responseType=json</code> between Opera 12 and Opera 15. Support is added again after it is implemented also in Blink (Opera 17).</p>

<p>[5] This feature was implemented in <a href="https://code.google.com/p/chromium/issues/detail?id=231959">bug 231959</a>.</p>

<p>[6] See <a href="https://dev.opera.com/articles/view/xhr2/#xhrtimeouts">how to set and handle timeouts</a>.</p>

<h2 id="See_also">See also</h2>

<ul>
 <li>MDN articles about XMLHttpRequest:
  <ul>
   <li><a href="/en-US/docs/AJAX/Getting_Started">AJAX - Getting Started</a></li>
   <li><a href="/en-US/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest">Using XMLHttpRequest</a></li>
   <li><a href="/en-US/docs/Web/API/XMLHttpRequest/HTML_in_XMLHttpRequest">HTML in XMLHttpRequest</a></li>
   <li><a href="/en-US/docs/Web/API/FormData"><code>FormData</code></a></li>
  </ul>
 </li>
 <li>XMLHttpRequest references from W3C and browser vendors:
  <ul>
   <li><a class="external" href="https://www.w3.org/TR/XMLHttpRequest1/">W3C: XMLHttpRequest</a> (base features)</li>
   <li><a class="external" href="https://dvcs.w3.org/hg/xhr/raw-file/tip/Overview.html">W3C: XMLHttpRequest</a> (latest editor's draft with extensions to the base functionality, formerly XMLHttpRequest Level 2</li>
   <li><a class="external" href="https://msdn.microsoft.com/library/default.asp?url=/library/en-us/xmlsdk/html/xmobjxmlhttprequest.asp">Microsoft documentation</a></li>
   <li><a class="external" href="https://developer.apple.com/library/safari/#documentation/AppleApplications/Conceptual/SafariJSProgTopics/Articles/XHR.html">Apple developers' reference</a></li>
  </ul>
 </li>
 <li><a class="external" href="https://jibbering.com/2002/4/httprequest.html">"Using the XMLHttpRequest Object" (jibbering.com)</a></li>
 <li><a class="external" href="https://www.peej.co.uk/articles/rich-user-experience.html">XMLHttpRequest - REST and the Rich User Experience</a></li>
 <li><a class="external" href="https://www.html5rocks.com/en/tutorials/file/xhr2/">HTML5 Rocks - New Tricks in XMLHttpRequest2</a></li>
 <li><a href="https://programmers.stackexchange.com/questions/157375/why-does-xmlhttprequest-not-seem-to-follow-a-naming-convention">Thread on the naming convention of <code>XMLHttpRequest</code></a></li>
 <li><code>Chrome scope availability</code> - how to access from JSM modules etc which do not have access to DOM
  <ul>
   <li><a href="/en-US/docs/Mozilla/Tech/XPCOM/Language_Bindings/Components.utils.importGlobalProperties">Components.utils.importGlobalProperties</a></li>
   <li><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIXMLHttpRequest">nsIXMLHttpRequest</a></li>
  </ul>
 </li>
</ul>
Revert to this revision