This page was translated from English by the community.Learn more and join the MDN Web Docs community.
XMLHttpRequest.readyState
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since июль 2015 г..
Свойство XMLHttpRequest.readyState возвращает текущее состояние объекта XMLHttpRequest. Объект XHR может иметь следующие состояния:
| Значение | Состояние | Описание |
|---|---|---|
0 | UNSENT | Объект был создан. Методopen() ещё не вызывался. |
1 | OPENED | Метод open() был вызван. |
2 | HEADERS_RECEIVED | Метод send() был вызван, доступны заголовки (headers) и статус. |
3 | LOADING | Загрузка;responseText содержит частичные данные. |
4 | DONE | Операция полностью завершена. |
- UNSENT
Объект XMLHttpRequest был создан, но метод
open()ещё не вызывался.- OPENED
Был вызван метод open(). На этом этапе методомsetRequestHeader() могут быть установлены заголовки запроса (request headers), после чего для начала выполнения запроса может быть вызван методsend() .
- HEADERS_RECEIVED
Был вызван метод send() и получены заголовки ответа (response headers) .
- LOADING
Получена часть ответа. Если
responseType- это пустая строка или имеет значение "text",responseTextбудет содержать загруженную порцию текста ответа.- DONE
Операция доставки данных завершена. Это может означать как то, что передача данных полностью завершена успешно, так и то, что произошла ошибка.
Примечание:Названия состояний отличаются в версиях Internet Explorer ранее 11. ВместоUNSENT,OPENED,HEADERS_RECEIVED,LOADING иDONE, используются названияREADYSTATE_UNINITIALIZED (0),READYSTATE_LOADING (1),READYSTATE_LOADED (2),READYSTATE_INTERACTIVE (3) иREADYSTATE_COMPLETE (4).
Пример
var xhr = new XMLHttpRequest();console.log("UNSENT", xhr.readyState); // readyState будет равно 0xhr.open("GET", "/api", true);console.log("OPENED", xhr.readyState); // readyState будет равно 1xhr.onprogress = function () { console.log("LOADING", xhr.readyState); // readyState будет равно 3};xhr.onload = function () { console.log("DONE", xhr.readyState); // readyState будет равно 4};xhr.send(null);Спецификации
| Specification |
|---|
| XMLHttpRequest # states |