xhr.js

xhr.js

xhr.js é uma biblioteca (<2Kb) para fazer solicitações tranquilas AJAX/HTTP com XMLHttpRequest . Possui API semelhante com Python-requests .

Uso

1. Instale xhr.js

npm install xhr.js

2. importar xhr.js

A importação UMD é suportada e, em seguida, obtenha o objeto global: XHR .

 import XHR from 'xhr.js' ;

// or

var XHR = require ( "xhr.js" ) ;

ou link com script em arquivos html:

 < script src = "dist/xhr.min.js" > </ script >

3. use a classe XHR

 var xhr = XHR ( async ) ; // default is async. you can set sync use  XHR(false)
xhr . on ( 'success' , function ( result ) {
	console . log ( 'status:' , result . status ) ;
	console . log ( 'statusText:' , result . statusText ) ;
	console . log ( 'url:' , result . url ) ;
	console . log ( 'responseType:' , result . responseType ) ;
	console . log ( 'text:' , result . text ) ;
	console . log ( 'headers:' , result . headers ) ;

	console . log ( 'ok:' , result . ok ( ) ) ; // get the json result.
	console . log ( 'json:' , result . json ( ) ) ; // get the json result.
	console . log ( 'xml:' , result . xml ( ) ) ;
	console . log ( 'blob:' , result . blob ( ) ) ;
} ) ;

xhr . get ( 'package.json' , { 'a' : 'b' } ) ;

Outra post de demonstração:

 var xhr = XHR ( ) ;
xhr . post ( '/post_url' , { 'a' : 'b' } , function ( r ) {
	r = r . json ( ) ; // get the json result.
	// write your code
} ) ;

Carregar arquivo com objeto FormData :

 var fd = new FormData ( document . querySelector ( '#submit_form' ) ) ;

var xhr = new XHR ( ) ;
xhr . post ( '/submit/new' , fd , function ( r ) {
    // request success
    r = r . json ( ) ;
    console . log ( r ) ;
} ) ;

API de detalhes

1. API XHR

A API da instância xhr.

1. xhr.request(method, url, body, onsuccess, onfail) : solicita a url, com o método.
2. xhr.on(event_key, event_func) : vincula o resultado da solicitação (pronto, erro, sucesso, falha), com a instância do resultado como entrada.
3. xhr.get(url, params, onsuccess, onfail) : obtém solicitação.
4. xhr.post(url, params, onsuccess, onfail) : solicitação de postagem.
5. xhr.setRequestHeader(header_name, header_value) : anexa um cabeçalho.
6. xhr.setAsync(aysnc) : define solicitação assíncrona/sincronizada.
7. xhr.url() : obtém o URL da solicitação.
8. xhr.body() : obtém o corpo da solicitação.
9. xhr.abort() : solicitação de aborto.
10. xhr.reset() : redefine a instância xhr, como URL, cabeçalhos, corpo, eventos.

2. Chave do evento XHR

As chaves evnet são para API on .

1. ready : quando xhr estiver pronto.
2. success : quando status_code is 200 .
3. fail : quando status_code is not 200 .

3. API de resposta

A API é para result do parâmetro da função de retorno de chamada de solicitação.

1. result.text : obtém todo o texto da resposta;
2. result.status : o código de resposta do servidor;
3. result.statusText : o texto do código de resposta do servidor, por exemplo, ok (o código de status é 200 ).
4. result.responseType : tipo de resposta;
5. result.headers : obtém todos os objetos de cabeçalhos de resposta;
6. result.ok() : a solicitação está ok;
7. result.json() : obtém o objeto json do texto de resposta;
8. result.xml() : obtém o objeto xml do texto de resposta;
9. result.blob() : obtém o objeto blob do texto de resposta;

PENDÊNCIA

• solicitar autorização
• um plugin de teste http do Chrome, como o carteiro.

LICENÇA

MIT