🎩 A HTTP library with redefined semantics based on Fetch
The Fetch API is awesome, but it might need some tweaks when it comes to error handling and body resolving, this library provides an alternative fetcher with the following semantics:
- success means a response with status < 400
- failure results from a response with status >= 400, or a network error (status defined as 0)
- response comes with a body already resolved
npm install semantic-fetch
It supports ES6 modules, AMD, CommonJS or a global variable as SemanticFetch
// use fetch polyfill of your choice
// import 'isomorphic-fetch'
import 'whatwg-fetch'
import { createFetch } from 'semantic-fetch'
const fetcher = createFetch(fetch)
fetcher('/api', { method: 'GET' })
.then(res => {
// response body is available
console.log(`${res.status} ${res.body}`)
})
.catch(res => {
if (res.status === 0)
console.log('network error')
else
console.log(`failed due to ${res.body}`)
})
Creates a fetch function
this fetch creator takes 2 arguments:
-
fetch
(function)the Fetch function, you can inject a fetch implementation of your choice
-
bodyResolvers
array of (function: (Response, Resolve callback, Next callback) => Unit) [Optional]an array of functions that take the response and two callbacks as arguments, then either call resolve callback to resolve the body content, e.g.
resolve(res.json())
, or pass to the next resolver by callingnext()
defaultBodyResolvers is used if the arg is not provided, which can be imported as
{ defaultBodyResolver }
, providing text and json resolvers
the enhanced fetch function that takes the same arguments as fetch
MIT