fetchival.js 

> Fork!
> Just added "response" to opts.responseAs property to allow access to response headers

> Makes writing JSON requests with fetch easier

Fetchival is a tiny (0.5kb min/gz) fetch wrapper that can be used in the __browser__ (IE9+) and __Node__.

__Before__

``javascript
// POST /users
fetch('/users', {
method: 'post',
headers: {
'Accept': 'application/json',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Typicode',
login: 'typicode',
})
})
.then(function(response) {
if (response.status >= 200 && response.status < 300) {
return response.json()
}
throw new Error(response.statusText)
})
.then(function(json) {
// ...
})
`

__After__

`javascript
// POST /users
fetchival('/users').post({
name: 'Typicode',
login: 'typicode'
})
.then(function(json) {
// ...
})
`

.get(), .put(), .patch() and .delete() methods are also available.

Installation

Fetchival is available on Bower and npm

__Browser__

`bash
bower install es6-promise fetch # polyfills
bower install fetchival
`

`bash
npm install es6-promise whatwg-fetch --save # polyfills
npm install fetchival --save # Browserify
`

__Node__

`bash
npm install node-fetch fetchival --save
`

Usage examples

`javascript
var posts = fetchival('/posts')

//posts
posts.get()
posts.post({ title: 'Fetchival' })

//posts?category=javascript
posts.get({ category: 'javascript' })

//posts/1
posts(1).get()
posts(1).put({ title: 'Fetchival is simple' })
posts(1).patch({ title: 'Fetchival is simple' })
posts(1).delete()

var comments = posts('1/comments')

//posts/1/comments
comments.get()

//posts/1/comments/1
comments(1).get()
`

You can also pass fetch options to fetchival()

`javascript
var posts = fetchival('/posts', fetchOptions)
var comments = posts('1/comments') // Will inherit fetchOptions
`

To catch errors

`javascript
fetchival('/posts')
.get()
.catch(function(err) {
console.log(err)
})
`

To enable CORS

`javascript
var request = fetchival('/', { mode: 'cors' })
var posts = request('posts')
`

To fetch plain text (for example, HTML views)

`javascript
var request = fetchival('/', { responseAs: 'text' })
var posts = request('posts')
`

responseAs must be either text or json (the default)

To use fetchival in Node, you need to install node-fetch and configure fetchival to use it

`javascript
var fetchival = require('fetchival')
fetchival.fetch = require('node-fetch')
``

Browser Support

!Chrome | !Firefox | !IE | !Opera | !Safari
--- | --- | --- | --- | --- |
Latest ✔ | Latest ✔ | 9+ ✔ | Latest ✔ | 6.1+ ✔ |

License

MIT - Typicode