JavaScript свойство XMLHttpRequest.status

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

JavaScript свойство status объекта XMLHttpRequest возвращает числовой код состояния HTTP ответа, полученный от сервера.

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

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

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

Показать браузеры

ВсеКомпьютерыМобильные

Совместимостьapi.XMLHttpRequest.status

Возможность	Компьютеры					Мобильные
	ChromeChrome	EdgeEdge	FirefoxFirefox	OperaOpera	SafariSafari	Chrome AndroidChromeAndroid	Firefox for AndroidFirefoxAndroid	Opera AndroidOperaAndroid	Safari on iOSSafariiOS	Samsung BrowserSamsungAndroid	WebView AndroidWebViewAndroid	WebView on iOSWebViewiOS
status	✓1	✓12	✓1	✓8	✓1.2	✓18	✓4	✓10.1	✓1	✓1.0	✓4.4	✓1

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

JavaScript синтаксис

xhr.status;

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

XMLHttpRequest Standard.

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

<button data-migration-click-0="">Запросить телефон</button>
<div id="demo"></div>

const getPhone = function () {
    let xhr = new XMLHttpRequest()
    xhr.open('GET', 'user-profile.json')
    xhr.send()

    xhr.onreadystatechange = function () {
        if (this.readyState == 4 && this.status == 200) {
            const data = JSON.parse(this.responseText)
            document.getElementById('demo').innerHTML = 'Телефон пользователя: ' + data.phone
        }
    }
}

// Обработчики кнопок перенесены из HTML для запуска с CSP без inline-скриптов.
document.querySelector('[data-migration-click-0]').addEventListener('click', function () {
    getPhone()
})
document.querySelector('[data-migration-click-0]').removeAttribute('data-migration-click-0')

Результат нашего примера:

В этом примере с использованием метода addEventListener() при нажатии на кнопку (HTML элемент <button>) вызываем функцию getPhone, которая:

• Вызывает конструктор объекта XMLHttpRequest и инициализирует переменную новым объектом этого типа.
• С помощью метода open() объекта XMLHttpRequest определяем параметры для запроса - указываем, что HTTP запрос будет осуществлен методом "GET", а в качестве URL адреса, на который будет отправлен запрос, мы задаем файл формата JSON. Файл размещен на том же сервере и в том же каталоге, что и документ, с которого выполняется скрипт. Файл имеет следующий вид:
  JSON

  {
     "firstName": "Василий",
     "lastName": "Джейсонов",
     "age": 25,
     "phone": 88005553535
  }
  

• С помощью метода send() объекта XMLHttpRequest отправляем запрос на сервер.
• С использованием обработчика событий onreadystatechange, вызываемого при запуске события readystatechange, то есть при каждом изменении свойства readyState объекта XMLHttpRequest мы вызываем функцию, которая проверяет состояние запроса, оно должно соответствовать значению 4 (операция полностью завершена) и числовой код состояния HTTP ответа (свойство status) должен соответствовать значению 200 (успешный запрос). Если условия выполнены, то с использованием метода JSON.parse() анализируем строку в формате JSON и инициализируем переменную значением, полученным в ходе анализа. После этого с помощью метода getElementById() находим элемент с определенным глобальным атрибутом id и изменяем его содержимое значением ключа объекта, содержащегося в инициализированной ранее переменной.