xhr.js
1.0.0
xhr.js は、 XMLHttpRequestを使用して AJAX/HTTP RESTful リクエストを作成するためのライブラリ (< 2Kb) です。
Python-requests
と同様の API があります。
1.xhr.jsをインストールする
npm install xhr.js
2.xhr.jsをインポートする
UMD インポートがサポートされている場合は、グローバル オブジェクト: XHR
を取得します。
import XHR from 'xhr.js' ;
// or
var XHR = require ( "xhr.js" ) ;
または、HTML ファイル内のscript
にリンクします。
< 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 ) ;
} ) ;
xhrインスタンスのAPI。
xhr.request(method, url, body, onsuccess, onfail)
: メソッドを使用して URL をリクエストします。xhr.on(event_key, event_func)
: リクエストの結果 (ready、error、success、fail) を入力として結果インスタンスにバインドします。xhr.get(url, params, onsuccess, onfail)
: リクエストを取得します。xhr.post(url, params, onsuccess, onfail)
: リクエストを投稿します。xhr.setRequestHeader(header_name, header_value)
: ヘッダーを追加します。xhr.setAsync(aysnc)
: リクエストの非同期/同期を設定します。xhr.url()
: リクエストの URL を取得します。xhr.body()
: リクエストボディを取得します。xhr.abort()
: リクエストを中止します。xhr.reset()
: URL、ヘッダー、本文、イベントなどの xhr インスタンスをリセットします。 evnet キーはon
API 用です。
ready
: xhr
準備ができたとき。success
: status_code is 200
場合。fail
: status_code is not 200
場合。 この API は、リクエストのコールバック関数のパラメータresult
用です。
result.text
: すべての応答テキストを取得します。result.status
: サーバー応答コード。result.statusText
: サーバー応答コードのテキスト、たとえばok
(ステータス コードは200
)。result.responseType
: 応答タイプ;result.headers
: すべての応答ヘッダー オブジェクトを取得します。result.ok()
: リクエストは OK です。result.json()
: 応答テキストの json オブジェクトを取得します。result.xml()
: 応答テキストの xml オブジェクトを取得します。result.blob()
: 応答テキストの blob オブジェクトを取得します。マサチューセッツ工科大学