http.js
is now deprecated since the introduction and adoption of the Fetch API, which is available in most modern browsers.
For use in older browsers, we recommend a polyfill, such as GitHub's implementation.
http.js
Make AJAX/HTTP requests from client-side JavaScript.
Introduction
http.js
provides a super simple, super easy way to make AJAX/HTTP requests. It's basically a few tiny functions to simplify XMLHttpRequest calls.
Usage
http.js
currently all HTTP methods. GET and POST requests are supported in short-hand form.
Pass in your options to the request
function (all are optional; defaults are shown):
var options = {
async: true,
contentType: 'text/plain',
data: null,
headers: {},
method: 'GET',
onerror: function() {},
onload: function() {},
onreadystatechange: function() {},
url: './',
props: []
}
Or use the shorthand functions get
and post
, which can take in a similar options object but without the need for a method.
Example usage
We can try a simple GET request:
http.get({
url: '/api/users',
onload: function() { console.log(JSON.parse(this.responseText)) }
});
Or a POST request:
var data = { name: 'http.js' }
http.post({
url: '/api/things',
data: JSON.stringify(data),
contentType: 'application/json',
onload: function() { console.log(JSON.parse(this.responseText)) }
});
Even a random DELETE:
http.request({
method: 'DELETE',
url: '/api/users/2',
onload: function() { console.log(JSON.parse(this.status)) }
});
A request with a custom timeout:
http.get({
url: '/api/poll',
contentType: 'application/json',
onload: function() { console.log(JSON.parse(this.responseText)) },
timeout: 3,
ontimeout: function() { console.log('Poll request timed out!') },
props: ['timeout', 'ontimeout']
});