blob: 329920fc6826c38fd8044ac04ffce246555c71f5 (
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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
---
title: XMLHttpRequest.upload
slug: Web/API/XMLHttpRequest/upload
translation_of: Web/API/XMLHttpRequest/upload
---
<div>{{APIRef('XMLHttpRequest')}}</div>
<p><span class="seoSummary">{{domxref("XMLHttpRequest")}} <code>upload</code> 프로퍼티는 업로드 진행 상황을 모니터링 할 수 있는 {{domxref("XMLHttpRequestUpload")}} 객체를 반환합니다.</span> 불투명한 객체(opaque object)이지만 {{domxref("XMLHttpRequestEventTarget")}} 이기도 하기 때문에 이벤트 리스너를 연결하여 프로세스를 추적할 수 있습니다.</p>
<p>upload 이벤트에서 다음 이벤트가 트리거되어 업로드를 모니터링하는데 사용할 수 있습니다.</p>
<table class="standard-table">
<tbody>
<tr>
<td class="header">Event</td>
<td class="header">Event listener</td>
<td class="header">Description</td>
</tr>
<tr>
<td>{{event("loadstart")}}</td>
<td>{{domxref("XMLHttpRequest.onloadstart", "onloadstart")}}</td>
<td>업로드가 시작되었습니다.</td>
</tr>
<tr>
<td>{{event("progress")}}</td>
<td>{{domxref("XMLHttpRequest.onprogress", "onprogress")}}</td>
<td>지금까지 진행된 상태를 정기적으로 제공합니다.</td>
</tr>
<tr>
<td>{{event("abort")}}</td>
<td>{{domxref("XMLHttpRequest.onabort", "onabort")}}</td>
<td>업로드가 중단되었습니다.</td>
</tr>
<tr>
<td>{{event("error")}}</td>
<td>{{domxref("XMLHttpRequest.onerror", "onerror")}}</td>
<td>에러로 인해 업로드에 실패했습니다.</td>
</tr>
<tr>
<td>{{event("load")}}</td>
<td>{{domxref("XMLHttpRequest.onload", "onload")}}</td>
<td>업로드가 성공적으로 완료되었습니다.</td>
</tr>
<tr>
<td>{{event("timeout")}}</td>
<td>{{domxref("XMLHttpRequest.ontimeout", "ontimeout")}}</td>
<td>{{domxref("XMLHttpRequest.timeout")}}에 명시되어 있는 시간 간격 내에 응답이 도착하지 않아, 업로드 시간이 초과되었습니다.</td>
</tr>
<tr>
<td>{{event("loadend")}}</td>
<td>{{domxref("XMLHttpRequest.onloadend", "onloadend")}}</td>
<td>업로드가 완료되었습니다. 이 이벤트는 성공과 실패를 구분하지 않고 결과에 관계없이 업로드가 끝나면 전송됩니다. 이 이벤트 발생 이전에는 전송이 종료된 이유를 나타내기 위해 <code>load</code>, <code>error</code>, <code>abort</code>, <code>timeout</code> 중 하나를 전달합니다.</td>
</tr>
</tbody>
</table>
<h2 id="Specifications">Specifications</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">Specification</th>
<th scope="col">Status</th>
<th scope="col">Comment</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName('XMLHttpRequest', '#the-upload-attribute')}}</td>
<td>{{Spec2('XMLHttpRequest')}}</td>
<td>WHATWG living standard</td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility">Browser compatibility</h2>
<p>{{Compat("api.XMLHttpRequest.upload")}}</p>
<h2 id="See_also">See also</h2>
<ul>
<li><a href="/en-US/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest">Using XMLHttpRequest</a></li>
<li><a href="/en-US/docs/Web/API/File_Handle_API">FileHandle API</a></li>
<li><a href="/en-US/docs/Web/API/File_and_Directory_Entries_API">File and Directory Entries API</a></li>
</ul>
|
