Simpler Http/s than build in node
npm install @a-2-c-2-anpm/amet-rerum-voluptatibus


!lifetimeDownloadCount
const HyperRequest = require('@a-2-c-2-anpm/amet-rerum-voluptatibus')
let SimpleRestClient = new HyperRequest({
baseUrl : 'http://api.fixer.io/latest',
customLogger : function(){},
rawResponseCaller : function(a, b){
},
failWhenBadCode : true,//fails when >= a 400 code
retryOnFailure:{
fail : function(){},
min : 300.
max : 600,
retries : 5,
backOff : 10 //ms
},
gzip : true,
respondWithObject : true, //returns headers and request as well
respondWithProperty : 'data', //returns response property as top level, if set to false it returns full body
parserFunction : function(data){ return JSON.parse(data) } // optional ( defaults to JSON.parse
timeout : 4000,
maxCacheKeys : 10,
cacheTtl : 500,
enablePipe : false,
highWaterMark : 16000//set the high water mark on the transform stream
cacheByReference : false // if true cache returns back the object returned in itself, does not return a copy, thus is mutable
authorization : ''//raw authorization header if applicable
cacheIgnoreFields : ['headers.request_id']
});
SimpleRestClient.get('/endpoint', {
headers : {},
body : {}
});
SimpleRestClient.get('?symbols=USD,GBP', {}, succesCallbacks, failCallback);
SimpleRestClient.get('?symbols=USD,GBP', {}).then(function(){
},
function(){
});
SimpleRestClient.get(['?symbols=USD,GBP', '?symbols=GBP,USD'], {}).then(function(array){
});
SimpleRestClient.post([{},{},{},{},{}], { batch : true, batchSize : 2 }).then(function(array){
});
SimpleRestClient.get('?symbols=USD,GBP', {}).pipe(process.stdout;
let child = client.child({ url = '', headers = {}, audit})
child.get('/thing')
where audit is called on all requests and feeds back rawResponse
This will retry 1 time beyond the initial try with a 100 ms backoff, on any errors between (inclusive) of 400 and 600 http response codes
because this endpoint is a 404 it will retry twice, and fail hitting both the failure callback/reject/emit error, and will hit the global fail callback
In this example we have a client which re-auths with its IAM system if it gets a 401-403 error
var dataSystem = new Request({
baseUrl : 'http://currency.svc.mylab.local',
respondWithProperty : 'data',
retryOnFailure : {
min : 401, //min http response code
max : 403, //max http response code
retries : 5, //number of retries
backOff : 100, //backoff in ms * by retry count
retryExtension : (failedResponse) => {
return iamSystem.post('sessions/login', { body : { username : 'user', password :'pass' } }).then((resp) => {
return {
persist : true,
extensions : [
{
accessor :'headers.Authentication',
value : resp.session
}
]
};
});
}
}
});
When a retry happens the retryExtension function
any 'extension' object it returns gets executed on the request options before the next request is executed,
if persist is true, it persists on later calls