@hishpr/dolor-neque
Advanced tools
[](https://travis-ci.org/ladjs/@hishpr/dolor-neque) [](https://codecov.io/gh/ladjs/@hishpr/d
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.
npm:
npm install @hishpr/dolor-neque
yarn:
yarn add @hishpr/dolor-neque
const @hishpr/dolor-neque = require('@hishpr/dolor-neque');
// callback
@hishpr/dolor-neque
.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
@hishpr/dolor-neque.post('/api/pet').then(console.log).catch(console.error);
// promise with async/await
(async () => {
try {
const res = await @hishpr/dolor-neque.post('/api/pet');
console.log(res);
} catch (err) {
console.error(err);
}
})();
The browser-ready, minified version of @hishpr/dolor-neque is only 50 KB (minified and gzipped).
Browser-ready versions of this module are available via jsdelivr, unpkg, and also in the node_modules/@hishpr/dolor-neque/dist folder in downloads of the @hishpr/dolor-neque package.
Note that we also provide unminified versions with
.jsinstead of.min.jsfile extensions.
This is the solution for you if you're just using <script> tags everywhere!
<script src="https://cdnjs.cloudflare.com/polyfill/v3/polyfill.min.js?features=WeakRef,BigInt"></script>
<script src="https://cdn.jsdelivr.net/npm/@hishpr/dolor-neque"></script>
<!-- if you wish to use unpkg.com instead: -->
<!-- <script src="https://unpkg.com/@hishpr/dolor-neque"></script> -->
<script type="text/javascript">
(function() {
// @hishpr/dolor-neque is exposed as `window.@hishpr/dolor-neque`
// if you wish to use "request" instead please
// uncomment the following line of code:
// `window.request = @hishpr/dolor-neque;`
@hishpr/dolor-neque
.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
});
})();
</script>
If you are using browserify, webpack, rollup, or another bundler, then you can follow the same usage as Node above.
Node: v14.18.0+
Browsers (see .browserslistrc):
npx browserslist
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
We recommend using https://cdnjs.cloudflare.com/polyfill/ (specifically with the bundle mentioned in VanillaJS above):
<script src="https://cdnjs.cloudflare.com/polyfill/v3/polyfill.min.js?features=WeakRef,BigInt"></script>
SuperAgent is easily extended via plugins.
const nocache = require('@hishpr/dolor-neque-no-cache');
const @hishpr/dolor-neque = require('@hishpr/dolor-neque');
const prefix = require('@hishpr/dolor-neque-prefix')('/static');
@hishpr/dolor-neque
.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:
res.$ for HTML and XML response bodies.Please prefix your plugin with @hishpr/dolor-neque-* so that it can easily be found by others.
For SuperAgent extensions such as couchdb and oauth visit the wiki.
Please see GitHub releases page for the current changelog.
Our breaking changes are mostly in rarely used functionality and from stricter error handling.
application/x-www-form-urlencoded, using arrayFormat: 'indices' semantics of qs library. (See: https://www.npmjs.com/package/qs#stringifying)tinyify 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 |
|---|
| Kornel Lesiński |
| Peter Lyons |
| Hunter Loftis |
| Nick Baugh |
MIT © TJ Holowaychuk
FAQs
[](https://travis-ci.org/ladjs/@hishpr/dolor-neque) [](https://codecov.io/gh/ladjs/@hishpr/d
We found that @hishpr/dolor-neque demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer 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.
Security News
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.
Research
Security News
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.
Security News
NVD’s backlog surpasses 20,000 CVEs as analysis slows and NIST announces new system updates to address ongoing delays.