xhr.js

xhr.js

xhr.js — это библиотека (< 2 КБ) для выполнения спокойных запросов AJAX/HTTP с помощью XMLHttpRequest . Имеет аналогичный API с Python-requests .

Использование

1. Установите xhr.js

npm install xhr.js

2. импортировать xhr.js

Импорт UMD поддерживается, затем получите глобальный объект: XHR .

 import XHR from 'xhr.js' ;

// or

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

или ссылку на script в html файлах:

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

3. используйте класс 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' } ) ;

Еще один демо- post :

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

Загрузите файл с объектом 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

1. XHR-API

API экземпляра xhr.

1. xhr.request(method, url, body, onsuccess, onfail) : запросить URL-адрес с помощью метода.
2. xhr.on(event_key, event_func) : свяжите результат запроса (готов, ошибка, успех, сбой) с экземпляром результата на входе.
3. xhr.get(url, params, onsuccess, onfail) : получить запрос.
4. xhr.post(url, params, onsuccess, onfail) : опубликовать запрос.
5. xhr.setRequestHeader(header_name, header_value) : добавить заголовок.
6. xhr.setAsync(aysnc) : установить асинхронный/синхронный запрос.
7. xhr.url() : получить URL-адрес запроса.
8. xhr.body() : получить тело запроса.
9. xhr.abort() : запрос на отмену.
10. xhr.reset() : сброс экземпляра xhr, такого как URL, заголовки, тело и события.

2. Ключ события XHR

Ключи evnet предназначены для API on .

1. ready : когда xhr будет готов.
2. success : когда status_code is 200 .
3. fail : когда status_code is not 200 .

3. API ответа

API предназначен для запроса result параметра функции обратного вызова.

1. result.text : получить весь текст ответа;
2. result.status : код ответа сервера;
3. result.statusText : текст кода ответа сервера, например ok (код состояния 200 ).
4. result.responseType : тип ответа;
5. result.headers : получить все объекты заголовков ответов;
6. result.ok() : запрос одобрен;
7. result.json() : получить объект json текста ответа;
8. result.xml() : получить объект xml текста ответа;
9. result.blob() : получить объект blob текста ответа;

TODO

• запросить авторизацию
• плагин HTTP-тестирования для Chrome, например почтальон.

ЛИЦЕНЗИЯ

Массачусетский технологический институт