O que significam os diferentes readystates em XMLHttpRequest e como posso usá-los?

113

XMLHttpRequesttem 5 readyStates, e só uso 1 deles (o último 4).

Para que servem os outros e em que aplicações práticas posso usá-los?

— Marius
fonte

172

A lista completa de readyStatevalores é:

State  Description
0      The request is not initialized
1      The request has been set up
2      The request has been sent
3      The request is in process
4      The request is complete

(de https://www.w3schools.com/js/js_ajax_http_response.asp )

Na prática, você quase nunca usa nenhum deles, exceto 4.

Algumas implementações de XMLHttpRequest podem permitir que você veja respostas parcialmente recebidas em responseTextquando readyState==3, mas isso não é universalmente suportado e não deve ser invocado.

— Kieron
fonte

5

Erros na transferência ainda atualizam o readyState para 4. No entanto, uma transferência completamente interrompida irá redefinir o readyState para 0. Portanto, um erro na transferência que é resultado de um redirecionamento não é realmente um "erro" e você pode escolher ignorar o registro / reportando o erro se o readyState do xhr for 0. É um pouco frágil e sua milhagem pode variar dependendo se o registro de cada evento / erro é um "obrigatório" ou um "bom ter". Se for o último, você pode perder o evento raro que pode ser um erro junto com o estado pronto de 0.

— Greg Pettit

2

+1 para @MattBianco por seus conselhos. Também gostaria de acrescentar que o Mozilla Developer Network MDN é indiscutivelmente um dos sites de referência mais populares e confiáveis para todas as suas necessidades de JavaScript / HTML / CSS. Ao fazer uma pesquisa no Google, inclua "mdn" antes de sua consulta e você evitará algumas dores de cabeça.

— DondeEstaMiCulo

@GregPettit, podemos usar readystate 0, para nenhuma conexão com a Internet, ou há algum motivo em que "A solicitação não foi inicializada"

— Vishal Sharma

4

Não tenho certeza, @vishalsharma - pelo que me lembro, o readystate é 0, desde que a solicitação não seja inicializada. Depois disso, qualquer outra "conclusão" (por sucesso ou erro) atualizará o readystate para 4. Portanto, perder a internet após o início da transferência o mudará para 4, e não para 0. Se nunca houve internet quando a transferência foi tentada, ainda deve estar em 0; ele só mudará para 1 após o handshake.

— Greg Pettit,

A explicação para readyState 2 está errada - ou pelo menos completamente enganosa. Claro que a solicitação foi enviada, mas esse estado na verdade diz que todos os cabeçalhos de resposta final foram recebidos.

— inta

32

kieron 's resposta contém w3schools ref. no qual ninguém confia, a resposta de bobince fornece um link, que na verdade informa a implementação nativa do IE,

então aqui está a documentação original citada para entender corretamente o que readystate representa:

O objeto XMLHttpRequest pode estar em vários estados. O atributo readyState deve retornar o estado atual, que deve ser um dos seguintes valores:

UNSENT (valor numérico 0)
O objeto foi construído.

OPENED (valor numérico 1)
O método open () foi chamado com sucesso. Durante esse estado, os cabeçalhos de solicitação podem ser definidos usando setRequestHeader () e a solicitação pode ser feita usando o método send ().

HEADERS_RECEIVED (valor numérico 2)
Todos os redirecionamentos (se houver) foram seguidos e todos os cabeçalhos HTTP da resposta final foram recebidos. Vários membros de resposta do objeto agora estão disponíveis.

LOADING (valor numérico 3)
O corpo da entidade de resposta está sendo recebido.

DONE (valor numérico 4)
A transferência de dados foi concluída ou algo deu errado durante a transferência (por exemplo, redirecionamentos infinitos).

Leia aqui: Explicação W3C de ReadyState

— Vishal Sharma
fonte

@CharlesWood, o desafio para mim foi aqui o editor de markdown stackoverflow não aceita consultar w3c .. confira, portanto, coloquei um url curto de goo.gl ... não entendo por que não me permite colocar diretamente url w3c ...

— Vishal Sharma

Huh, eu apenas tentei isso na caixa de areia e pareceu funcionar.

— Charles Wood

22

Documentação definitiva original

0, 1E 2única acompanhar como muitos dos métodos necessários para fazer um pedido que você chamou até agora.

3informa que a resposta do servidor começou a chegar. Mas quando você está usando o XMLHttpRequestobjeto de uma página da web, não há quase nada (*) que você possa fazer com essa informação, já que você não tem acesso às propriedades estendidas que permitem você a ler os dados parciais.

readyState 4é o único que possui algum significado.

(*: quase o único uso concebível que posso pensar para verificar o readyState 3é que ele sinaliza alguma forma de vida no final do servidor, então você pode aumentar o tempo de espera por uma resposta completa quando a receber.)

— bobince
fonte

1

onreadystatechange Armazena uma função (ou o nome de uma função) a ser chamada automaticamente sempre que a propriedade readyState muda. readyState Contém o status do XMLHttpRequest. Mudanças de 0 a 4:

0: solicitação não inicializada

1: conexão do servidor estabelecida

2: pedido recebido

3: solicitação de processamento

4: pedido concluído e resposta pronta

status 200: "OK"

404 Página Não Encontrada

— omertalmi
fonte

0

0: Cliente NÃO ENVIADO criado. open () ainda não chamado.
1: OPENED open () foi chamado.
2: HEADERS_RECEIVED send () foi chamado, e cabeçalhos e status estão disponíveis.
3: CARREGANDO Baixando; responseText contém dados parciais.
4: DONE A operação está concluída.

(De https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/readyState)

— Khurshid Ansari
fonte