XMLHttpRequest: responseType 속성

값

응답에 포함된 데이터의 유형을 지정하는 문자열로, 다음과 같은 값을 가질 수 있습니다.

• ""
  • : responseType의 빈 문자열은 기본 유형인 "text"와 동일합니다.
• "arraybuffer"
  • : response는 바이너리 데이터를 포함하고 있는 JavaScript ArrayBuffer입니다.
• "blob"
  • response는 바이너리 데이터를 포함한 Blob 객체입니다.
• "document"
  • response는 전달받은 데이터의 MIME 유형에 따라 HTML Document 또는 XML XMLDocument입니다. HTML에서의 XMLHttpRequest에서 HTML 콘텐츠를 가져오는 XHR 사용법을 확인해보세요.
• "json"
  • response는 전달받은 데이터의 내용을 JSON 형식으로 파싱해 생성된 JavaScript 객체입니다.
• "text"
  • : response는 문자열의 텍스트입니다.

예외

Worker가 아닌 동기적 모드의 XMLHttpRequest에서 responseType 값을 변경하려는 시도가 있었습니다. 자세한 내용은 아래의 XHR 동기 제한를 참조하세요.

사용 일람

XHR 동기 제한

Worker에 속한 요청이 아닌 경우, 동기 XMLHttpRequest에서 responseType 값을 변경할 수 없습니다. 이러한 제한은 브라우저의 메인 스레드를 차단해 사용자 경험을 저하시키는 대규모 동기 작업에 사용되지 않도록 하기 위한 설계입니다.

XHR 요청은 기본적으로 비동기입니다. open()을 호출할 때 선택적 async 매개변수에 false를 전달하면 동기 모드로 설정됩니다.

Workers 제한

responseType 값을 document로 설정하려는 시도는 Worker 내에서는 무시됩니다.

명세서

브라우저 호환성

Enable JavaScript to view this browser compatibility table.

같이 보기

• XMLHttpRequest 사용하기
• HTML에서의 XMLHttpRequest
• 응답 데이터: response, responseText, responseXML