forwardemail /superagent
Ajax for Node.js and browsers (JS HTTP client). Maintained for @forwardemail, @ladjs, @spamscanner, @breejs, @cabinjs, and @lassjs.
★ 16,640⑂ 1,326👁 213⑃ 717● 1,105▤ 102
+2
日增长
16,640
stars
1,326
forks
213
watchers
717
prs
1,105
issues
102
releases
README
superagent
Small progressive client-side HTTP request library, and Node.js module with the same API, supporting many high-level HTTP client features. Maintained for Forward Email and Lad.
Table of Contents
Install
Usage
Node
Browser
Supported Platforms
Required Browser Features
Plugins
Upgrading from previous versions
Contributors
License
Install
[npm][]:
sh
npm install superagent
[yarn][]:
sh
yarn add superagent
Usage
Node
js
const superagent = require('superagent');
// callback
superagent
.post('/api/pet')
.send({ name: 'Manny', species: 'cat' }) // sends a JSON post body
.set('X-API-Key', 'foobar')
.set('accept', 'json')
.end((err, res) = {
// Calling the end function will send the request
});
// promise with then/catch
superagent.post('/api/pet').then(console.log).catch(console.error);
// promise with async/await
(async () = {
try {
const res = await superagent.post('/api/pet');
console.log(res);
} catch (err) {
console.error(err);
}
})();
Browser
The browser-ready, minified version of superagent is only 50 KB (minified and gzipped).
Browser-ready versions of this module are available via [jsdelivr][], [unpkg][], and also in the node_modules/superagent/dist folder in downloads of the superagent package.
Note that we also provide unminified versions with .js instead of .min.js file extensions.
VanillaJS
This is the solution for you if you're just using tags everywhere!
html
--
(function() {
// superagent is exposed as window.superagent
// if you wish to use "request" instead please
// uncomment the following line of code:
// window.request = superagent;
superagent
.post('/api/pet')
.send({ name: 'Manny', species: 'cat' }) // sends a JSON post body
.set('X-API-Key', 'foobar')
.set('accept', 'json')
.end(function (err, res) {
// Calling the end function will send the request
});
})();
Bundler
If you are using [browserify][], [webpack][], [rollup][], or another bundler, then you can follow the same usage as Node above.
Supported Platforms
Node: v14.18.0+
Browsers (see .browserslistrc):
sh
npx browserslist
sh
and_chr 102
and_ff 101
and_qq 10.4
and_uc 12.12
android 101
chrome 103
chrome 102
chrome 101
chrome 100
edge 103
edge 102
edge 101
firefox 101
firefox 100
firefox 91
ios_saf 15.5
ios_saf 15.4
ios_saf 15.2-15.3
ios_saf 15.0-15.1
ios_saf 14.5-14.8
ios_saf 14.0-14.4
ios_saf 12.2-12.5
kaios 2.5
op_mini all
op_mob 64
opera 86
opera 85
safari 15.5
safari 15.4
samsung 17.0
samsung 16.0
Required Browser Features
We recommend using (specifically with the bundle mentioned in VanillaJS above):
html
WeakRef is not supported in Opera 85, iOS Safari 12.2-12.5
BigInt is not supported in iOS Safari 12.2-12.5
Plugins
SuperAgent is easily extended via plugins.
js
const nocache = require('superageTop issues
Latest release
v10.4.2 v10.4.2 2026-11-07- fix: let unset() remove default and differently cased headers cc24a56 --- https://github.com/ladjs/superagent/compare/v10.4.1...v10.4.2