General purpose HTTP request library with consistent behaviour.
Works in node.js and in the browser.
It is 100% Axios compatible, with some extra defaults and features.
npm install caxios
and then
const { getJSON, postJSON } = require('caxios');
// basic data fetching
getJSON('/api/data').then(res => console.log(res.data));
// posting JSON data (for ex.: a form) and handling server-side validation
postJSON('/api/data', { some: 'values', in: 'here' })
.then(res => console.log(res.data))
.catch(err => err.isValidation()
// catch stats code 422 (used for validation errors)
? console.log('Validation errors:', err.response.data)
: console.log('Some other error', err)
)
Caxios uses the following defaults:
- request timeout = 3 seconds (by default Axios uses infinity)
post
,put
andpatch
methods sendContent-Type: application/json
header (by default Axios sendsContent-Type: application/x-www-form-urlencoded
)- all utility functions with with JSON suffix (
getJSON
,postJSON
,putJSON
,delJSON
) sendAccept: application/json
header (by default Axios sendsapplication/json, text/plain, */*
for all requests)
Caxios does NOT modify the global axios
instance.
While Axios is an excellent library, its default behaviour may not be ideal. Caxios aims to address this by introducing the following features:
- easier and consistent error handling
- utility functions for making requests that accept only JSON responses
- support for HTTP status code
422
-Unprocessable Entity
(used for validation errors) - support for malformed JSON response handling
Rejected request error objects are extended with additional methods:
isFormat()
- true if the client expected JSON response, but server returned malformed JSONisCancel()
- true if the request was cancelled by the clientisNetwork()
- true for any network error (timeout, server unavailable, CORS etc.)isValidation()
- true if responsestatus
==422
(used for validation errors)
These error types are mutually exclusive, so only one of those methods returns true for any error.
const { getJSON } = require('caxios');
getJSON('/some/data')
// Axios
axios.get('/some/data', { headers: { 'Accept': 'application/json' } })
const { getJSON, makeCancelSource } = require('caxios');
const cancelSource = makeCancelSource();
cancelSource.cancel();
getJSON('/some/data', { cancelSource })
.catch(err => console.log(err.isCancel())); // true
// Axios
axios.get('/some/data', { cancelToken: cancelSource.token })
.catch(err => console.log(axios.isCancel(err))); // true
getJSON('http://no-such-address.com')
.catch(err => {
console.log(err.isCancel()); // false
console.log(err.isNetwork()); // true
});
// Axios
axios.get('http://no-such-address.com')
.catch(err => {
console.log(axios.isCancel(err)); // false
console.log(!axios.isCancel(err) && !err.response); // true
});
getJSON('/returns/non-json-response')
.catch(err => {
console.log(err.isFormat()); // true
console.log(err.message); // JSON parsing error message
});
// Axios swallows JSON parsing errors, so you have to
// manually verify response format in the successful response handler
getJSON('/this/returns/422')
.catch(err => {
console.log(err.response.status); // 422
console.log(err.isValidation()); // true
console.log(err.response.data); // validation errors passed in response body
});