fetch-fetchy

A simplified fetch API

→ Methods for each HTTP verb means no building request objects

→ API-level error handling means no checking status codes

→ Built-in response parsing means no additional checks and method calls

→ Optional one-time configuration means easy integration for your API

Install

$ npm i --save fetch-fetchy

Basic Usage

import { get, post } from 'fetch-fetchy';

/**
 * Create a user
 */
post('/user', formData)
  .then(onSuccess)
  .catch(onError)

/**
 * Fetch a user
 */
get('/user/hs9hsbs7')
  .then(onSuccess)
  .catch(onError)

Configuration

The default configuration is as follows:

{
	json: true,
	url: window.location.origin,
	headers: { 'Content-Type': 'application/json' },
	mode: 'cors'
}

json

If set to true, request data will automatically be converted to JSON.

url

The url to be used for api requests. When a route begins with /, it is assumed that the request is being made to the application's API. This means that you can define /user as the route instead of https://myapplicationdomain/user. If you set url to https://someotherdomain and specify /user as the route, the request will be made to https://someotherdomain/user. When the route does not begin with /, the full route will be used.

headers

The headers for requests.

mode

The request mode.

---

You may override these options for all requests by calling configure(). The default options will be overridden using Object.assign(). If you wish to apply options for a single request, just pass those options into that request.

import { configure } from 'fetch-fetchy';
/**
 * Configure fetch-fetchy
 */
const options = {
  url: 'https://myapi.com',
  headers: { Authorization: `Bearer ${jwt}`},
}
configure(options);

API Methods

get(route: String, options: Object) => Promise

post(route: String, body: *, options: Object) => Promise

put(route: String, body: *, options: Object) => Promise

patch(route: String, body: *, options: Object) => Promise

del(route: String, options: Object) => Promise

configure(options: Object) => Object