request-sa
v1.0.0
Published
universal http lib with request like api over superagent
Downloads
12
Readme
request-sa
We follow [breaking].[feature].[fix] versioning
npm install --save request-sa
An universal version of the node.js library request
- Uses superagent to achieve its "universal" nature
Version 1.0.0
Usage
Below is a sample code for how to use this library:
const request = require('request-sa');
request({
method: 'POST', // http method of the request
headers: {}, // request headers
qs: {}, // query string map. Best used in GET requests
json: {}, // send data like this for application/json requests. can also be set to "true",
form: {}, // send data like this for application/x-www-form-urlencoded requests
formData: (() => {
const form = new FormData();
form.append('foo', 'bar');
form.append('file', someFile);
return form;
})(), // send data like this for multipart/form-data requests
getFullResponse: false // optional, defaults to "false". By default, successful requests only return response body
}).then((resOrBody) => {
// do something with res or body
}).catch((err) => {
// do something with err
});
You can access the set of active-requests and check if the library is busy like this:
console.log(request.activeRequests); // request.activeRequests is a "Set"
console.log(request.isBusy()); // true or false
You can also abort a request midway like this:
const reqPromise = request({...});
reqPromise.abort();
Todo:
- Include cookie support.
- Include session support.