XMLHttpRequest: свойство statusText

Базовая Широко доступная

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

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

Только для чтения XMLHttpRequest.statusText свойство возвращает строку, содержащую сообщение об ответе, возвращённое HTTP-сервером. В отличие от XMLHTTPRequest.status, которое указывает числовой код состояния, это свойство содержит текст сообщения об ответе, например, "OK" или "Not Found". Если состояние запроса readyState находится в состоянии UNSENT или OPENED, значение statusText будет пустой строкой.

Если сервер не указывает явное сообщение об ответе, statusText будет использовать значение по умолчанию "OK".

Примечание: Ответы по HTTP/2 соединению всегда будут иметь пустую строку как сообщение об ответе, поскольку HTTP/2 не поддерживает их.

Значение

Строка.

Примеры

const xhr = new XMLHttpRequest();
console.log("0 UNSENT", xhr.statusText);

xhr.open("GET", "/server", true);
console.log("1 OPENED", xhr.statusText);

xhr.onprogress = () => {
  console.log("3 LOADING", xhr.statusText);
};

xhr.onload = () => {
  console.log("4 DONE", xhr.statusText);
};

xhr.send(null);

/**
 * Outputs the following:
 *
 * 0 UNSENT
 * 1 OPENED
 * 3 LOADING OK
 * 4 DONE OK
 */

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

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

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

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`statusText`	1	12	1	≤12.1	1.2	18	4	≤12.1	1	1.0	4.4

См. также

© 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/statusText