Product
Introducing SSO
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
@ladjs/superagent
Advanced tools
Readme
Small progressive client-side HTTP request library, and Node.js module with the same API, sporting many high-level HTTP client features
npm:
npm install superagent
yarn:
yarn add superagent
const superagent = require('superagent');
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
});
The browser-ready, minified version of superagent
is only 19 KB!
Browser-ready versions of this module are available via jsdelivr, unpkg, and also in the node_modules/superagent/dist
folder in npm downloads of superagent
.
Note that we also provide unminified versions with .js
instead of .min.js
file extensions if needed.
This is the solution for you if you're just using <script>
tags everywhere!
<script src="https://cdn.jsdelivr.net/npm/superagent"></script>
<!-- if you wish to use unpkg.com instead: -->
<!-- <script src="https://unpkg.com/superagent"></script> -->
<script type="text/javascript">
(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((err, res) => {
// Calling the end function will send the request
});
})();
</script>
If you are using browserify, webpack, rollup, or another bundler, then you can follow the same usage as Node above.
Node: v8.8.1+ (we use the core http2
package)
Browsers (see .browserslistrc):
cd superagent
npx browserslist
and_chr 69
and_ff 62
and_qq 1.2
and_uc 11.8
android 67
android 4.4.3-4.4.4
baidu 7.12
bb 10
bb 7
chrome 69
chrome 68
chrome 67
edge 17
edge 16
firefox 62
firefox 61
ie 11
ie 10
ie 9
ie_mob 11
ie_mob 10
ios_saf 11.3-11.4
ios_saf 11.0-11.2
op_mini all
op_mob 46
op_mob 12.1
opera 55
opera 54
safari 12
safari 11.1
samsung 7.2
samsung 6.2
IE9 requires a polyfill for
window.FormData
(we recommend formdata-polyfill)
SuperAgent is easily extended via plugins.
const nocache = require('superagent-no-cache');
const superagent = require('superagent');
const prefix = require('superagent-prefix')('/static');
superagent
.get('/some-url')
.query({ action: 'edit', city: 'London' }) // query string
.use(prefix) // Prefixes *only* this request
.use(nocache) // Prevents caching of *only* this request
.end((err, res) => {
// Do something
});
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.
Our breaking changes are mostly in rarely used functionality and from stricter error handling.
http2
module nowtinyify
and the latest version of Babel using @babel/preset-env
and .browserslistrc
)caniuse-lite
and eslint-plugin-compat
.babelrc
.end()
callbacks to .then()
or await
..send()
multiple times. Invalid calls to .send()
will now throw instead of sending garbage..parse()
in the browser version, rename it to .serialize()
.undefined
in query-string values being sent literally as the text "undefined", switch to checking for missing value instead. ?key=undefined
is now ?key
(without a value)..then()
in Internet Explorer, ensure that you have a polyfill that adds a global Promise
object..end(function(res){})
use .then(res => {})
.Name | Website |
---|---|
TJ Holowaychuk | http://tjholowaychuk.com |
Kornel Lesiński | |
Peter Lyons | |
Hunter Loftis | |
Nick Baugh |
FAQs
Small progressive client-side HTTP request library, and Node.js module with the same API, sporting many high-level HTTP client features
The npm package @ladjs/superagent receives a total of 132 weekly downloads. As such, @ladjs/superagent popularity was classified as not popular.
We found that @ladjs/superagent demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 3 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.