JavaScript метод XMLHttpRequest.overrideMimeType()

Определение и применение

JavaScript метод overrideMimeType() объекта XMLHttpRequest позволяет переопределить MIME тип, возвращаемый сервером (задает тип MIME, отличный от того, который предоставляется сервером для использования при интерпретации данных, передаваемых в запросе).

Поддержка браузерами

Спецификация: xhr.spec.whatwg

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьapi.XMLHttpRequest.overrideMimeType
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
overrideMimeType✓1✓12✓1✓≤12.1✓1.2✓18✓4✓≤12.1✓1✓1.0✓4.4✓1

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

JavaScript синтаксис

JavaScript
xhr.overrideMimeType(mimeType);

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

XMLHttpRequest Standard.

Значения параметров

Параметры XMLHttpRequest.overrideMimeType()
Параметр Описание
mimeType Строковое значение, указывающее тип MIME для использования вместо указанного сервером. Если строку не удается разобрать как MIME-тип, используется application/octet-stream. Без переопределения и без заголовка Content-Type в ответе XMLHttpRequest предполагает text/xml. Обязательное значение.

Исключения

Исключения XMLHttpRequest.overrideMimeType()
Тип исключения Описание
InvalidStateError Возникает, если запрос уже находится в состоянии LOADING или DONE.

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

В следующем примере мы создадим функцию, которая позволит интерпретировать полученные данные от сервера как обычный текст за счет переопределения методом overrideMimeType() MIME типа, возвращаемого сервером.

JavaScript
function interpretAsPlainText(url, callback) {
	let xhr = new XMLHttpRequest(); // инициализируем переменную новым объектом XMLHttpRequest

	xhr.open("GET", url); // определяем параметры для запроса на определенный адрес
	xhr.overrideMimeType("text/plain"); // переопределяем MIME тип, возвращаемый сервером
	xhr.send(); // отправляем запрос на сервер
	xhr.onload = function() { // добавляем обработчик события
	    callback(xhr); // вызываем функцию обратного вызова
	}
}