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 July 2015.
A propriedade XMLHttpRequest.readyState retorna o estado de um XMLHttpRequest. Uma requisição XHR que existe em um dos seguintes estados:
Valor | Estado | Descrição |
---|---|---|
0 |
UNSENT |
Um cliente foi criado. Mas o método open() não foi chamado ainda. |
1 |
OPENED |
O método open() foi chamado . |
2 |
HEADERS_RECEIVED |
o método send() foi chamado e os cabeçalhos e status estão disponíveis . |
3 |
LOADING |
Baixando e responseText contem os dados parciais. |
4 |
DONE |
Operação concluída. |
- UNSENT
-
O XMLHttpRequest foi criado. Mas o método open() não foi chamado ainda.
- OPENED
-
O método open() foi invocado. Durante esse estado, os headers da requisição podem ser inseridos usando o método setRequestHeader() e o método send() pode ser chamado, iniciando a busca.
- HEADERS_RECEIVED
-
O método send() foi chamado e os cabeçalhos de respostas foram recebidos.
- LOADING
-
A resposta da requisição está sendo recebida. se o
responseType
for "text" ou um texto em branco, oresponseText
terá o texto parcial da resposta conforme seu carregamento. - DONE
-
A Operação de busca está completa. Isso pode significar que a trasferência foi concluída com êxito ou que falhou.
Nota:
Os nomes de estado são diferentes no Internet Explorer. Ao invés de UNSENT
, OPENED
, HEADERS_RECEIVED
, LOADING
e DONE
, os nomes usados são: READYSTATE_UNINITIALIZED
(0), READYSTATE_LOADING
(1), READYSTATE_LOADED
(2), READYSTATE_INTERACTIVE
(3) e READYSTATE_COMPLETE
(4).
Exemplo
var xhr = new XMLHttpRequest();
console.log("UNSENT", xhr.readyState); // readyState will be 0
xhr.open("GET", "/api", true);
console.log("OPENED", xhr.readyState); // readyState will be 1
xhr.onprogress = function () {
console.log("LOADING", xhr.readyState); // readyState will be 3
};
xhr.onload = function () {
console.log("DONE", xhr.readyState); // readyState will be 4
};
xhr.send(null);
Especificações
Specification |
---|
XMLHttpRequest Standard # states |
Compatibilidade com navegadores
BCD tables only load in the browser