fitch

Fitch.js

A lightweight Promise based HTTP client, using Fetch API.

Features

• Uses Fetch API
• Works on both old and new browsers and on Node.js
• Supports the Promise API
• Transform request and response data
• Automatic transforms for JSON data

Get started

Read the full Documentation

Install

npm i --save fitch

Use

With ES2015 or TypeScript:

import fitch from 'fitch'

CommonJS:

const fitch = require('fitch')

UMD:

<script src="https://unpkg.com/fitch/dist/index.umd.min.js"></script>

Make your first request:

fitch.get(apiUrl)
  .then(response => console.log(response))

/* Response:
{
  data: { foo: 'bar' },
  status: 200,
  statusText: 'Ok',
  headers: { Content-Type: application/json },
}
*/

Methods available:

get

fitch.get(apiUrl)
  .then(response => console.log(response))

post

const req = {body: {name: 'Happy cat'}}

fitch.post(apiUrl, req)
  .then(response => console.log(response))

put

const req = {body: {name: 'Happy cat'}}

fitch.put(apiUrl, req)
  .then(response => console.log(response))

patch

const req = {body: {name: 'Happy cat'}}

fitch.patch(apiUrl, req)
  .then(response => console.log(response))

del

fitch.del(apiUrl)
  .then(response => console.log(response))

Use with custom configuration

const config = {
  cache = 'no-store',
  headers = { 'Content-Type': 'application/json' },
  mode = 'no-cors',
  params: { // transform to '?test1=test-1&test2=test-2'
    test1: 'test-1',
    test2: 'test-2',
  },
  raw = true, // return the raw output of fetch()
  redirect: 'follow',
}

fitch.get(apiUrl, config)
  .then(response => console.log(response))

See more about fetch configuration at: Fetch API.

Concurrency

all

Helper function for dealing with concurrent requests.

const reqDogs = fitch.get('/dogs')
const reqCats = fitch.get('/cats')

function doSomething([ responseDogs, responseCats ]) {
  console.log('Dogs\t>>>', responseDogs)
  console.log('Cats\t>>>', responseCats)
}

fitch.all([ reqDogs, reqCats ])
  .then(doSomething)

Browser Support

| | | | | | --------- | --------- | --------- | --------- | --------- | --------- | | IE10, IE11, Edge| Every versions| Every versions| 6.1+|

Note: modern browsers such as Chrome, Firefox, and Microsoft Edge contain native implementations of window.fetch, so the polyfill doesn't have any affect on those browsers. See more at window.fetch polyfill.

Contributig

Read the Code of conduct.

First yout need to fork this repository. Then:

npm i # install local dependencies
npm start # run local server
npm run watch:test # watch files inside src/ and tests/
npm run examples # run examples

Note: Your code must be tested and pass in linter check. You can verify your code with ESLint, using npm run lint.

Logo

Copyright © Bárbara Schoen