XMLHttpRequest: свойство responseType

Базовая Широко поддерживается

Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

Примечание: Эта функция доступна в Web Workers, за исключением Service Workers.

Свойство XMLHttpRequest responseType — это перечисляемое строковое значение, определяющее тип данных, содержащихся в ответе.

Он также позволяет автору изменить тип ответа. Если пустая строка установлена в качестве значения responseType, используется значение по умолчанию text.

Значение

Строка, определяющая тип данных ответа. Она может принимать следующие значения:

"": Пустая responseType строка эквивалентна "text", типу по умолчанию.
"arraybuffer": Значение response — это JavaScript ArrayBuffer, содержащий двоичные данные.
"blob": Значение response — это объект Blob, содержащий двоичные данные.
"document": Значение response — это HTML Document или XML XMLDocument, в зависимости от MIME-типа полученных данных. См. HTML в XMLHttpRequest, чтобы узнать больше о использовании XHR для получения HTML-контента.
"json": Значение response — это JavaScript-объект, созданный путём парсинга содержимого полученных данных как JSON.
"text": Значение response — это текст в строке.

Примечание: При установке responseType в определённое значение, автор должен убедиться, что сервер фактически отправляет ответ, совместимый с этим форматом. Если сервер возвращает данные, не совместимые с responseType значением, которое было установлено, значение response будет null.

Исключения

InvalidAccessError DOMException: Была предпринята попытка изменить значение responseType в XMLHttpRequest синхронном режиме, но не в Worker. Дополнительные сведения см. в разделе Ограничения синхронного XHR ниже.

Примечания по использованию

Ограничения синхронного XHR

Вы не можете изменить значение responseType в синхронном XMLHttpRequest запросе, за исключением случаев, когда запрос принадлежит Worker. Это ограничение частично разработано для того, чтобы гарантировать, что синхронные операции не используются для больших транзакций, которые блокируют основной поток браузера, тем самым ухудшая пользовательский опыт.

XHR-запросы по умолчанию асинхронны; они переходят в синхронный режим только при передаче false в качестве значения необязательного параметра async при вызове open().

Ограничения в работниках

Попытки установить значение responseType в document игнорируются в Worker.

Спецификации

Спецификация
XMLHttpRequest # the-responsetype-attribute

Совместимость браузеров

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`responseType`	31	12	6	1812–15	5.1	31	50	1812–14	5	2.0	4.4.3
`arraybuffer_value`	31	12	6	1812–15	5.1	31	50	1812–14	5	2.0	4.4.3
`blob_value`	31	12	6	1812–15	5.1	31	50	1812–14	5	2.0	4.4.3
`document_value`	31	12	11	1812–15	7	31	50	1812–14	7	2.0	4.4.3
`json_value`	31	79	10	1812–15	7	31	50	1812–14	7	2.0	4.4.3

См. также

Использование XMLHttpRequest
HTML в XMLHttpRequest
Данные ответа: response, responseText и responseXML

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/responseType