unfetcher v1.1.2

unfetcher

unfetch wrapper for creating predefined abortable requests with Typescript support

Features

• Uses a modified version of unfetch internally (Thanks to developit and other contributors ✌, see LICENSE-unfetch.md)
• Supports older browsers if Promise is polyfilled (promise-polyfill - ~1kb gzipped)
• Compact - about 740B gzipped
• Standalone - no dependencies
• Abortable without polyfills

Install

Save as dependency using npm

npm i unfetcher

Import in your module bundler

import Fetcher from 'unfetcher'; // ES6
var Fetcher = require('unfetcher'); // CommonJS

Or expose globally as Unfetcher using UMD build from unpkg

<script src="//unpkg.com/unfetcher/dist/unfetcher.umd.js"></script>

Specs

• rejects an ABORT message Error on request abort
• rejects an TIMEOUT message Error on request timeout
• Error with ABORT message is catched internally by default in Fetcher.onCatch, to change this behavior modify this static method

Fetcher constructor options:

Usage

Optionally configure for application/json communication to reduce boilerplate:

import Fetcher from 'unfetcher';

Fetcher.prepare = (params) => JSON.stringify(params);
Fetcher.headers = {'Content-Type': 'application/json'};
// Fetcher.transform = (params, request) => JSON.parse(params); // default behavior

Javascript, GET:

import Fetcher from 'unfetcher';

const GETPreactStars = new Fetcher({
    url: 'https://api.github.com/repos/developit/preact'
});

GETPreactStars.fetch()
    .then((data) => console.log(data.watchers_count));

// or
GETPreactStars.fetchR()
    .then((response) => response.json())
    .then((data) => console.log(data.watchers_count));

Typescript, GET:

import Fetcher from 'unfetcher';

// Define API response model
type GithubRepoResponse = {
    watchers_count: number;
    // ...
};

const GETPreactStars = new Fetcher<GithubRepoResponse>({
    url: 'https://api.github.com/repos/developit/preact'
});

GETPreactStars.fetch()
    .then((data) => console.log(data.watchers_count)); // strongly typed