XMLHttpRequest.upload

XMLHttpRequest upload 프로퍼티는 업로드 진행 상황을 모니터링 할 수 있는 XMLHttpRequestUpload (en-US) 객체를 반환합니다. 불투명한 객체(opaque object)이지만 XMLHttpRequestEventTarget (en-US) 이기도 하기 때문에 이벤트 리스너를 연결하여 프로세스를 추적할 수 있습니다.

upload 이벤트에서 다음 이벤트가 트리거되어 업로드를 모니터링하는데 사용할 수 있습니다.

Event Event listener Description
loadstart (en-US) onloadstart 업로드가 시작되었습니다.
progress (en-US) onprogress 지금까지 진행된 상태를 정기적으로 제공합니다.
abort (en-US) onabort 업로드가 중단되었습니다.
error (en-US) onerror 에러로 인해 업로드에 실패했습니다.
load onload 업로드가 성공적으로 완료되었습니다.
timeout ontimeout XMLHttpRequest.timeout에 명시되어 있는 시간 간격 내에 응답이 도착하지 않아, 업로드 시간이 초과되었습니다.
loadend (en-US) onloadend 업로드가 완료되었습니다. 이 이벤트는 성공과 실패를 구분하지 않고 결과에 관계없이 업로드가 끝나면 전송됩니다. 이 이벤트 발생 이전에는 전송이 종료된 이유를 나타내기 위해 load, error, abort, timeout 중 하나를 전달합니다.

명세서

Specification
XMLHttpRequest Standard
# the-upload-attribute

브라우저 호환성

BCD tables only load in the browser

See also