An tiny and minimal function for XMLHttpRequests. Falls back to ActiveX for older versions of Internet Explorer.

Xhr is a component.

$ component install matthewp/xhr

Perform a GET request to the given url, calling the callback when complete. If an error is encountered, the errback function will be called with an XhrError instance.

Perform an HTTP requests with the given options, calling callback when complete. If an error is encountered, the errback function will be called with an XhrError instance.

The options object has the following properties:

The url to perform the request on.

The HTTP method to use (GET, POST, PUT, DELETE, etc.). Defaults to GET.

An Object in which the keys are the header key and the values are the header value. Example

headers: {
  'Accept': 'application/json'
}

The data to send along as the body of the request. For example, in a POST request.

If true, the withCredentials value will be applied to the XMLHttpRequest object, which allows for CORS requests.

var xhr = require('xhr');
var fooData = JSON.stringify({
  foo: 'bar',
  baz: 'qux'
});
xhr({
  url: 'https://example.com/foos',
  headers: {
    'Content-Type': 'application/json',
    'Content-Length': fooData.length
  },
  method: 'POST',
  data: fooData
},
  function onSuccess() {
    console.log('It worked!');
  },
  function onError(err) {
    console.log('There was an error: ' + err.message);
  });