https://github.com/sdd/fetch-nice

A thin wrapper around fetch to take care of some common use cases in the browser.
https://github.com/sdd/fetch-nice

fetch whatwg-fetch

Last synced: 15 days ago
JSON representation

A thin wrapper around fetch to take care of some common use cases in the browser.

• Host: GitHub
• URL: https://github.com/sdd/fetch-nice
• Owner: sdd
• License: mit
• Created: 2017-04-26T06:45:35.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-12-15T15:00:24.000Z (about 1 year ago)
• Last Synced: 2024-12-01T01:44:09.523Z (about 1 month ago)
• Topics: fetch, whatwg-fetch
• Language: JavaScript
• Homepage:
• Size: 11.7 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# fetch-nice

[![Travis](https://img.shields.io/travis/sdd/fetch-nice.svg)]() [![npm](https://img.shields.io/npm/v/fetch-nice.svg)]() [![npm](https://img.shields.io/npm/l/fetch-nice.svg)]() [![David](https://img.shields.io/david/sdd/fetch-nice.svg)]()

A thin wrapper around fetch to take care of some common use cases in the browser.

NB This does not handle polyfilling fetch. If you are using this in a browser that does not implement HTML5 Fetch API

 then you will need to polyfill with something like [`whatwg-fetch`](https://www.npmjs.com/package/whatwg-fetch) or it will not work.

 

## Installation

```bash

npm i fetch-nice

```

## Usage

The examples below are written using ES7 async/await for clarity. Of course you can still use fetch-nice without async/await since it returns a promise as per HTML5 fetch.

fetchNice assumes that your request is for JSON and sets headers accordingly. It also defaults to using fetch's `credentials: 'include'` setting so that any cookies are sent in order to make authenticated API requests.

The response object is JSON parsed automatically. If the response was a 204 (no content), fetch-nice returns `undefined`.

fetch-nice returns a rejected promise for error responses. If the error response contained a JSON body, this is added to the rejected Error.

fetch-nice uses [`boom`](https://www.npmjs.com/package/boom) for it's errors.

```js

import fetchNice from 'fetch-nice';

// make a GET request

const result = await fetchNice('http://myapi.com/user/me');

// make a POST request

const body = { name: 'Onion McOnionFace' };

const result = await fetchNice.post('http://myapi.com/users', { body });

// PUT and DELETE follow the same pattern.

```