fetchival.js

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

// POST /usersfetch('/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){returnresponse.json()}thrownewError(response.statusText)}).then(function(json){// ...})

After

// POST /usersfetchival('/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

bower install es6-promise fetch # polyfills
bower install fetchival

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

Node

npm install node-fetch fetchival --save

Usage examples

varposts=fetchival('/posts')//postsposts.get()posts.post({title: 'Fetchival'})//posts?category=javascriptposts.get({category: 'javascript'})//posts/1posts(1).get()posts(1).put({title: 'Fetchival is simple'})posts(1).patch({title: 'Fetchival is simple'})posts(1).delete()varcomments=posts('1/comments')//posts/1/commentscomments.get()//posts/1/comments/1comments(1).get()

You can also pass fetch options to fetchival()

varposts=fetchival('/posts',fetchOptions)varcomments=posts('1/comments')// Will inherit fetchOptions

To catch errors

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

To enable CORS

varrequest=fetchival('/',{mode: 'cors'})varposts=request('posts')

To fetch plain text (for example, HTML views)

varrequest=fetchival('/',{responseAs: 'text'})varposts=request('posts')

responseAs can be response, text or json (default)

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

varfetchival=require('fetchival')fetchival.fetch=require('node-fetch')

Browser Support

Latest ✔	Latest ✔	9+ ✔	Latest ✔	6.1+ ✔

License

MIT - Typicode