• Stars
    star
    517
  • Rank 82,177 (Top 2 %)
  • Language
    JavaScript
  • License
    MIT License
  • Created about 9 years ago
  • Updated over 5 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Easy window.fetch requests

fetchival.js Travis

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 /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

// 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

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

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()

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

To catch errors

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

To enable CORS

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

To fetch plain text (for example, HTML views)

var request = fetchival('/', { responseAs: 'text' })
var posts = 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

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

More Repositories

1

json-server

Get a full fake REST API with zero coding in less than 30 seconds (seriously)
JavaScript
70,794
star
2

husky

Git hooks made easy 🐶 woof!
JavaScript
31,302
star
3

lowdb

Simple and fast JSON database
JavaScript
20,699
star
4

hotel

🏩 A simple process manager for developers. Start apps from your browser and access them using local domains
JavaScript
9,953
star
5

jsonplaceholder

A simple online fake REST API server
HTML
4,945
star
6

tlapse

📷 Create a timelapse of your web development... or just automatically take screenshots of your hard work ;)
JavaScript
2,026
star
7

xv

🙅‍♀️ ✌️ fastest test runner
JavaScript
829
star
8

pegasus

Load JSON while still loading other scripts
JavaScript
702
star
9

katon

(use hotel instead)
JavaScript
683
star
10

steno

Super fast async file writer with atomic write ⚡
JavaScript
664
star
11

react-fake-props

🔮 Magically generate fake props for your React tests
JavaScript
628
star
12

lodash-id

Makes it easy to manipulate id-based resources with lodash or lowdb
JavaScript
467
star
13

react-lodash

⚛️ 🔧 Lodash as React components
JavaScript
356
star
14

stop-server

📱 Shut down your computer with your phone
JavaScript
341
star
15

demo

A demo repository for My JSON Server (Alpha)
326
star
16

pinst

🍺 dev only postinstall hooks (package.json)
JavaScript
256
star
17

please-upgrade-node

💁 Show a message to your users to upgrade Node instead of a stacktrace
JavaScript
238
star
18

jsop

JSON file reader/writer (powered by Object.observe)
JavaScript
205
star
19

mistcss

Write atomic React components using only CSS! (JS-from-CSS™) 🌬️
JavaScript
168
star
20

husky-4-to-8

Quickly migrate your hooks from husky v4 to husky@latest
JavaScript
126
star
21

user-startup

Auto start commands when you log in (cross-platform)
JavaScript
123
star
22

cult

cult monitors gulpfile changes and reloads gulp
JavaScript
118
star
23

logan

Mini template system for the console and colors
JavaScript
80
star
24

bg.nvim

Automatically sync your terminal background with your colorscheme 🎆
Lua
70
star
25

minihost

Easily start and access servers
JavaScript
45
star
26

ghwn

Get desktop notifications for new issues, comments, stars... (no installation required)
HTML
42
star
27

shoutjs

Make your ShellJS commands explicit and get a beautiful output
JavaScript
29
star
28

homerun

Turn npm package scripts into CLI commands
JavaScript
24
star
29

server-ready

Know when a server is ready to receive requests
JavaScript
20
star
30

husky-init

JavaScript
20
star
31

backbone-pegasus

Load models and collections data while loading Backbone
JavaScript
19
star
32

server-ready-cli

Run commands only when a server is available
JavaScript
18
star
33

typicode.github.io

HTML
7
star
34

eslint-config

JavaScript
7
star