tiny http client for Node and the browser
npm install xhr-request
An extremely tiny HTTP/HTTPS request client for Node and the browser. Uses xhr in the browser and simple-get in Node.
Supported response types: JSON, ArrayBuffer, and text (default).
For streaming requests, you can just use simple-get directly. It works in Node/browser and supports true streaming in new versions of Chrome/FireFox.
``sh`
npm install xhr-request --save
A simple example, loading JSON:
`js
var request = require('xhr-request')
request('http://foo.com/some/api', {
json: true
}, function (err, data) {
if (err) throw err
// the JSON result
console.log(data.foo.bar)
})
`
Another example, sending a JSON body with a query parameter. Receives binary data as the response.
`js
var request = require('xhr-request')
request('http://foo.com/some/api', {
method: 'PUT',
json: true,
body: { foo: 'bar' },
responseType: 'arraybuffer',
query: {
sort: 'name'
}
}, function (err, data) {
if (err) throw err
console.log('got ArrayBuffer result: ', data)
})
`
There are a lot of HTTP clients, but most of them are Node-centric and lead to large browser bundles with builtins like url, buffer, http, zlib, streams, etc.
With browserify, this bundles to 7kb minified. Compare to 742kb for request, 153kb for got, 74kb for simple-get, and 25kb for nets.
#### req = xhrRequest(url, [opt], [callback])
Sends a request to the given url with optional opt settings, triggering callback on complete.
Options:
- query (String|Object)headers
- the query parameters to use for the URL
- (Object)json
- the headers for the request
- (Boolean) responseType
- if true, defaults to 'json' and body will be sent as JSONresponseType
- (String)'text'
- can be , 'arraybuffer' or 'json''text'
- defaults to unless json is truebody
- (String|JSON)json
- an optional body to send with request
- sent as text unless is truemethod
- (String)'GET'
- an optional method to use, defaults to timeout
- (Number)
- milliseconds to use as a timeout, defaults to 0 (no timeout)
The callback is called with the arguments (error, data, response)
- error on success will be null/undefineddata
- the result of the request, either a JSON object, string, or ArrayBufferresponse
- the request response, see below
The response object has the following form:
`js`
{
statusCode: Number,
method: String,
headers: {},
url: String,
rawRequest: {}
}
The rawRequest is the XMLHttpRequest in the browser, and the http response in Node.
Since opt is optional, you can specify callback as the second argument.
#### req.abort()
The returned req (the ClientRequest or XMLHttpRequest) has an abort()` method which can be used to cancel the request and send an Error to the callback.
- simple-get
- xhr
- got
- nets
- superagent
- axios
MIT, see LICENSE.md for details.