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>
|