[JavaScript] XMLHttpRequest란?

XMLHttpRequest에 대해 알아보자

 

 

[ XMLHttpRequest ]

브라우저는 주소창이나 HTML의 form 태그 또는 a 태그를 통해 HTTP 요청 전송 기능을 기본 제공한다. 자바스크립트를 사용하여 HTTP 요청을 전송하려면 XMLHttpRequest 객체를 사용한다.

 

Web API인 XMLHttpRequest 객체는 HTTP 요청 전송과 HTTP 응답 수신을 위한 다양한 메서드와 프로퍼티를 제공한다.

 

 

[ XMLHttpRequest 객체 생성 ]

XMLHttpRequest 객체는 XMLHttpRequest 생성자 함수를 호출하여 생성한다. XMLHttpRequest 객체는 브라우저에서 제공하는 Web API이므로 브라우저 환경에서만 정상적으로 실행된다.

 

// XMLHttpRequest 객체의 생성
const xhr = new XMLHttpRequest();

 

 

[ XMLHttpRequest 객체의 프로퍼티와 메서드 ] 

XMLHttpRequest 객체는 다양한 프로퍼티와 메서드를 제공한다. 대표적인 프로퍼티와 메서드는 다음과 같다. 

 

 

많이 쓰이는 것 : 빨간색

 

※ XMLHttpRequest 객체의 프로토타입 프로퍼티

 

프로토타입 프로퍼티	설명
readyState	HTTP 요청의 현재 상태를 나타내는 정수. 다음과 같은 XMLHttpRequest의 정적 프로퍼티를 값으로 갖는다. UNSENT: 0 OPENED: 1 HEADERS_RECEIVED: 2 LOADING: 3 DONE: 4
status	HTTP 요청에 대한 응답 상태(HTTP 상태 코드)를 나타내는 정수 예) 200
statusText	HTTP 요청에 대한 응답 메시지를 나타내는 문자열 예) "OK"
responseType	HTTP 응답 타입 예) document, json, text, blob, arraybuffer
response	HTTP 요청에 대한 응답 몸체(response body).  responseType에 따라 타입이 다르다.
responseText	서버가 전송한 HTTP 요청에 대한 응답 문자열

 

 

※ XMLHttpRequest 객체의 이벤트 핸들러 프로퍼티 

 

이벤트 핸들러 프로퍼티	설명
onreadystatechange	readystate 프로퍼티 값이 변경된 경우
onloadstart	HTTP 요청에 대한 응답을 받기 시작한 경우
onprogress	HTTP 요청에 대한 응답을 받는 도중 주기적으로 발생
onabort	abort 메서드에 의해 HTTP 요청이 중단된 경우
onerror	HTTP 요청에 에러가 발생한 경우
onload	HTTP 요청이 성공적으로 완료한 경우
ontimeout	HTTP 요청 시간이 초과한 경우
onloadend	HTTP 요청이 완료한 경우. HTTP 요청이 성공 또는 실패하면 발생

 

 

※ XMLHttpRequest 객체의 메서드

 

메서드	설명
open	HTTP 요청 초기화
send	HTTP 요청 전송
abort	이미 전송된 HTTP 요청 중단
setRequestHeader	특정 HTTP 요청 헤더의 값을 설정
getResponseHeader	특정 HTTP 요청 헤더의 값을 문자열로 반환

 

 

※ XMLHttpRequest 객체의 정적 프로퍼티

 

정적 프로퍼티	값	설명
UNSENT	0	open 메서드 호출 이전
OPENED	1	open 메서드 호출 이후
HEADERS_RECEIVED	2	send 메서드 호출 이후
LOADING	3	서버 응답 중(응답 데이터 미완성 상태)
DONE	4	서버 응답 완료

 

 

[ HTTP 요청 전송 ]

HTTP 요청을 전송하는 경우 다음 순서를 따른다.

 

1. XMLHttpRequest.prototype.open 메서드로 HTTP 요청을 초기화한다.

 

2. 필요에 따라 XMLHttpRequest.prototype.setRequestHeader 메서드로 특정 HTTP 요청의 헤더 값을 설정한다.

 

3. XMLHttpRequest.prototype.send 메서드로 HTTP 요청을 전송한다. 

 

 

// XMLHttpRequest 객체 생성
const xhr = new XMLHttpRequest();
 
// HTTP 요청 초기화
xhr.open('GET', '/users');
 
// HTTP 요청 헤더 설정
// 클라이언트가 서버로 전송할 데이터의 MIME 타입 지정: json
xhr.setRequestHeader('content-type', 'application/json');
 
// HTTP 요청 전송
xhr.send();

 

 

 

※ XMLHttpRequest.prototype.open 

 

open 메서드는 서버에 전송할 HTTP 요청을 초기화한다. open 메서드를 호출하는 방법은 다음과 같다.

 

xhr.open(method, url[, async])

 

매개변수	설명
method	HTTP 요청 메서드("GET", "POST", "PUT", "DELETE" 등)
url	HTTP 요청을 전송할 URL
async	비동기 요청 여부. 옵션으로 기본값은 true이며, 비동기 방식으로 동작한다.

 

 

HTTP 요청 메서드는 클라이언트가 서버에게 요청의 종류와 목적(리소스에 대한 행위)을 알리는 방법이다. 주로 5가지 요청 메서드 (GET, POST, PUT, PATCH, DELETE 등)를 사용하여 CRUD를 구현한다.

 

HTTP 요청 메서드	종류	목적	페이로드
GET	index / retrieve	모든 / 특정 리소스 취득	X
POST	create	리소스 생성	O
PUT	replace	리소스의 전체 교체	O
PATCH	modify	리소스의 일부 수정	O
DELETE	delete	모든 / 특정 리소스 삭제	X

 

 

 

※ XMLHttpRequest.prototype.send

 

send 메서드는 open 메서드로 초기화된 HTTP 요청을 서버에 전송한다. 기본적으로 서버로 전송하는 데이터는 GET, POST 요청 메서드에 따라 전송 방식에 차이가 있다. 

 

1. GET 요청 메서드의 경우 데이터를 URL의 일부분인 쿼리 문자열(query string)로 서버에 전송한다.

 

2. POST 요청 메서드의 경우 데이터(페이로드 payload)를 요청 몸체(request body)에 담아 전송한다.

 

send 메서드에는 요청 몸체에 담아 전송할 데이터(페이로드)를 인수로 전달할 수 있다. 페이로드가 객체인 경우 반드시 JSON.stringify 메서드를 사용하여 직렬화한 다음 전달해야 한다.

 

xhr.send(JSON.stringify({ id: 1, content: 'HTML', completed: false }));

 

HTTP 요청 메서드가 GET인 경우 send 메서드에 페이로드로 전달한 인수는 무시되고 요청 몸체는 null로 설정된다.

 

 

 

※ XMLHttpRequest.prototype.setRequestHeader

 

setRequestHeader 메서드는 특정 HTTP 요청의 헤더 값을 설정한다. setRequestHeader 메서드는 반드시 open 메서드를 호출한 이후에 호출해야 한다. 자주 사용하는 HTTP 요청 헤더인 Content-type과 Accept에 대해 살펴보자. 

 

Content-type은 요청 몸체에 담아 전송할 데이터의 MIME 타입의 정보를 표현한다.

자주 사용되는 MIME 타입은 다음과 같다. 

 

★ MIME 타입이란?

 

MIME 타입이란 클라이언트에게 전송된 문서의 다양성을 알려주기 위한 메커니즘이다. 웹에서 파일의 확장자는 별 의미가 없다. 그러므로, 각 문서와 함께 올바른 MIME 타입을 전송하도록, 서버가 정확히 설정하는 것이 중요하다.

 

REF:https://developer.mozilla.org/ko/docs/Web/HTTP/Basics_of_HTTP/MIME_types

 

MIME 타입	서브타입
text	text/plain, text/html, text/css, text/javascript
application	application/json, application/x-www-form-urlencode
multipart	multipart/formed-data

 

다음은 요청 몸체에 담아 서버로 전송할 페이로드의 MIME 타입을 지정하는 예다.

 

// XMLHttpRequest 객체 생성
const xhr = new XMLHttpRequest();
 
// HTTP 요청 초기화
xhr.open('POST', '/users');
 
// HTTP 요청 헤더 설정
// 클라이언트가 서버로 전송할 데이터의 MIME 타입 지정: json
xhr.setRequestHeader('content-type', 'application/json');
 
// HTTP 요청 전송
xhr.send(JSON.stringify({ id: 1, content: 'HTML', completed: false }));

 

HTTP 클라이언트가 서버에 요청할 때 서버가 응답할 데이터의 MIME 타입을 Accept로 지정할 수 있다. 

다음은 서버가 응답할 데이터의 MIME 타입을 지정하는 예다.

 

// 서버가 응답할 데이터의 MIME 타입 지정: json
xhr.setRequestHeader('accept', 'application/json');

 

만약 Accept 헤더를 설정하지 않으면 send 메서드가 호출될 때 Accept 헤더가 */*으로 전송된다.