jquery ajaxreadystate

jquery-ajaxreadystate

Plug-in jQuery ajaxreadystate

Visão geral

A implementação jQuery AJAX é um tanto limitada porque não fornece uma maneira de responder aos eventos readystatechange que são acionados durante a solicitação AJAX. A documentação da API jQuery.ajax afirma o seguinte.

No entanto, nenhum mecanismo onreadystatechange é fornecido, uma vez que done , fail , always e statusCode cobrem todos os requisitos concebíveis.

Embora essa afirmação seja verdadeira para a maioria dos casos de uso, e se você quiser acessar os cabeçalhos de resposta ou o código de status antes que toda a solicitação seja concluída ou acessar o corpo da resposta durante o fluxo?

Evidentemente o jQuery não fornece esta funcionalidade devido a problemas de compatibilidade do navegador, então este plugin adiciona esta funcionalidade extra para navegadores que suportam esses recursos (veja notas de compatibilidade abaixo).

Este plugin funciona adicionando um novo método jQuery.ajaxreadystate , que atua como um wrapper para jQuery.ajax , estendendo a funcionalidade e atualizando o objeto jqXHR para remover as limitações e atualizar as propriedades conforme o readyState muda.

Uso

Você usa jQuery.ajaxreadystate exatamente como faria com jQuery.ajax , exceto que você tem um método extra que pode definir, o método readystate .

 jQuery . ajaxreadystate ( {
	readystate : function ( jqXHR , readyState ) {
		
	}
} ) ;

Este método será acionado sempre que a solicitação disparar um evento readystatechange e passará o objeto jqXHR atualizado e o readyState atual.

Download

Você pode baixar a versão estável e reduzida mais recente na seção de lançamentos deste repositório. Alternativamente, você pode clonar o download do repositório de um gerenciador de pacotes.

Compatibilidade do navegador

###Totalmente Suportado

Os seguintes navegadores são totalmente suportados.

• Firefox 3+
• Cromo 14+
• Internet Explorer 10+
• Safári 5+
• Safári iOS 4+
• Ópera 15+

###Parcialmente Suportado

Os seguintes navegadores são parcialmente suportados devido a limitações técnicas do próprio navegador. Problemas de compatibilidade são observados.

• Internet Explorer 9
  • responseText não está disponível até que readyState seja 4 .
  • Dispara apenas um evento readystatechange para readyState 3 em algum momento durante a transferência.
• Internet Explorer 7-8
  • responseText não está disponível até que readyState seja 4 .
  • status e statusText não são atualizados até que readyState seja 4 .
  • getAllResponseHeaders e getResponseHeader retornam null até que readyState seja 4 .
• Internet Explorer 6
  • O retorno de chamada readystate só é acionado para readyState 1 .
  • responseText não está disponível até que readyState seja 4 .
  • status e statusText não são atualizados até que readyState seja 4 .
  • getAllResponseHeaders e getResponseHeader retornam null até que readyState seja 4 .
• Safári 4
  • getAllResponseHeaders e getResponseHeader retornam null até que readyState seja 3 .
• iOS Safári 3
  • getAllResponseHeaders e getResponseHeader retornam null até que readyState seja 3 .
• Ópera 11.6-12.16
  • Dispara apenas um evento readystatechange para readyState 3 em algum momento durante a transferência.
• Ópera 11.1-11.5
  • status e statusText não são atualizados até que readyState seja 3 .
  • Dispara apenas um evento readystatechange para readyState 3 em algum momento durante a transferência.
• Ópera 10.6
  • status e statusText não são atualizados até que readyState seja 3 .
  • Dispara apenas um evento readystatechange para readyState 3 em algum momento durante a transferência.
  • getAllResponseHeaders e getResponseHeader retornam null até que readyState seja 4 .

Navegadores mais antigos que os listados não foram testados, mas podem ser parcial ou totalmente suportados.

Compatibilidade com jQuery

Este plugin é compatível com jQuery 1.5+ e jQuery 2.0.0+.

Desenvolvimento

Para criar uma compilação reduzida, execute este comando no diretório raiz deste repositório.

$ npm run build

Erros

Se você encontrar um bug ou tiver problemas de compatibilidade não documentados acima, abra um ticket na seção de problemas deste repositório.

Licença

Consulte LICENSE.txt

Se esta licença não funcionar para você, sinta-se à vontade para entrar em contato comigo.

Doações

Se você achar meu software útil, considere fazer uma modesta doação em meu site em alexomara.com.