SuperAgent ![Build Status](https://travis-ci.org/visionmedia/superagent.svg?branch=master)
![Sauce Test Status](https://saucelabs.com/browser-matrix/shtylman-superagent.svg)
SuperAgent is a small progressive client-side HTTP request library, and Node.js module with the same API, sporting many high-level HTTP client features. View the docs.
![super agent](http://f.cl.ly/items/3d282n3A0h0Z0K2w0q2a/Screenshot.png)
Installation
node:
$ npm install superagent
component:
$ component install visionmedia/superagent
Works with browserify and should work with webpack
request
.post('/api/pet')
.send({ name: 'Manny', species: 'cat' })
.set('X-API-Key', 'foobar')
.set('Accept', 'application/json')
.end(function(err, res){
});
Supported browsers
Tested browsers:
- Latest Android
- Latest Firefox
- Latest Chrome
- IE9 through latest
- Latest iPhone
- Latest Safari
Even though IE9 is supported, a polyfill window.btoa
is needed to use basic auth.
Plugins
Superagent is easily extended via plugins.
var nocache = require('no-cache');
var request = require('superagent');
var prefix = require('superagent-prefix')('/static');
prefix(request);
request
.get('/some-url')
.use(nocache)
.end(function(err, res){
});
Existing plugins:
Please prefix your plugin with superagent-*
so that it can easily be found by others.
For superagent extensions such as couchdb and oauth visit the wiki.
Running node tests
Install dependencies:
$ npm install
Run em!
$ make test
Running browser tests
Install dependencies:
$ npm install
Start the test runner:
$ make test-browser-local
Visit http://localhost:4000/__zuul
in your browser.
Edit tests and refresh your browser. You do not have to restart the test runner.
License
MIT