aboutsummaryrefslogtreecommitdiff
path: root/files/es/web/api/xmlhttprequesteventtarget/index.html
blob: f53063d82b81a7993bcb58bb5ca30399a0598b6c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
---
title: XMLHttpRequestEventTarget
slug: Web/API/XMLHttpRequestEventTarget
tags:
  - AJAX
  - API
  - NeedsBrowserCompatibility
  - NeedsContent
  - NeedsTranslation
  - Reference
  - TopicStub
  - XMLHttpRequest
translation_of: Web/API/XMLHttpRequestEventTarget
---
<p>{{APIRef("XMLHttpRequest")}}</p>

<p><code>XMLHttpRequestEventTarget</code> is the interface that describes the event handlers you can implement in an object that will handle events for an {{ domxref("XMLHttpRequest") }}.</p>

<p>{{InheritanceDiagram}}</p>

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

<dl>
	<dt>{{ domxref("XMLHttpRequestEventTarget.onabort") }}</dt>
	<dd>Contains the function to call when a request is aborted and the {{event('abort')}} event is received by this object.</dd>
	<dt>{{ domxref("XMLHttpRequestEventTarget.onerror") }}</dt>
	<dd>Contains the function to call when a request encounters an error and the {{event('error')}} event is received by this object.</dd>
	<dt>{{ domxref("XMLHttpRequestEventTarget.onload") }}</dt>
	<dd>Contains the function to call when an HTTP request returns after successfully fetching content and the {{event('load')}} event is received by this object.</dd>
	<dt>{{ domxref("XMLHttpRequestEventTarget.onloadstart") }}</dt>
	<dd>Contains the function that gets called when the HTTP request first begins loading data and the {{event('loadstart')}} event is received by this object.</dd>
	<dt>{{ domxref("XMLHttpRequestEventTarget.onprogress") }}</dt>
	<dd>Contains the function that is called periodically with information about the progress of the request and the {{event('progress')}} event is received by this object.</dd>
	<dt>{{ domxref("XMLHttpRequestEventTarget.ontimeout") }}</dt>
	<dd>Contains the function that is called if the event times out and the {{event("timeout")}} event is received by this object; this only happens if a timeout has been previously established by setting the value of the <code>XMLHttpRequest</code> object's <code>timeout</code> attribute.</dd>
	<dt>{{ domxref("XMLHttpRequestEventTarget.onloadend") }}</dt>
	<dd>Contains the function that is called when the load is completed, even if the request failed, and the {{event('loadend')}} event is received by this object.</dd>
</dl>

<h2 id="Specifications">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>{{Compat("api.XMLHttpRequestEventTarget")}}</p>

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

<ul>
	<li>{{ domxref("XMLHttpRequest") }}</li>
	<li><a href="/en/DOM/XMLHttpRequest/Using_XMLHttpRequest" title="Using XMLHttpRequest">Using XMLHttpRequest</a></li>
</ul>