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
JavaScriptMITCreated 2011-04-13forwardemail.github.io/superagent/
下载:v10.4.2superagent-10.4.2 ↓10.4.22026-11-07
+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('superage

Top 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON