A small wrapper around fetch that throws custom http errors


1.0.23 years ago3 years agoMinified + gzip package size for @financial-times/ip-wxp-fetch-wrapper in KB



CircleCI npm version

A small wrapper around fetch that throws custom HTTP errors.


Install via npm:

  npm i -S @financial-times/ip-wxp-fetch-wrapper


A common pattern for fetch with async await looks like the below:

  const { AMAZING_KEY: API_KEY } = process.env
  const response = await fetch('http://www.amazing.com/awesome-json', {
    method: 'POST',
    headers: {  API_KEY, 'content-type': 'application/json' },
    body: { awesomeness: 9000 }

  if(response.status === 200) {
    console.log( await response.json())
  } else {
    // deal with the fetch error somehow
    throw Error('fetch failed for some reason')
} catch(err) {
  // handle the URL/fetch error somehow e.g pass it to an error handler middleware in express

This module wraps much of that pattern and throws custom HTTP Errors if fetch fails.

const { create } = require('@financial-times/ip-wxp-fetch-wrapper')
const { AMAZING_KEY: API_KEY } = process.env
const api = create('http://www.amazing.com', { headers: { 'content-type': 'application/json', 'API_KEY': 'AWESOME-KEY' }}, { bodyParser: 'text', errorParser: 'json', fetch: window.fetch})

  const result = await api.post('/awesome-json', { body: { awesomeness: 9000 } }
  console.log(result) // receives a JSON object
} catch(err) {
  // will receive an HTTP Error with a status and name e.g. status: 404, name: NotFound



Returns a function with a canned configuration for querying an api.


The HTTP Verb to be used for the request e.g GET


The base url for requests, should be parsable by URL. This should include the protocol, hostname and port used by the request, it can also contain a partial pathname.


Additional options:

  • fetch - the fetch implementation to use (default: isomorphic-fetch)
  • bodyParser - the body mixin function to use (default: json)
  • errorParser - the body mixin function to use for error responses (default: bodyParser setting)

Returns a method used to make an http request taking following arguments:

  • pathname - this will be concatenated onto the base url
  • options - an object of fetch options, this is merged with the config options passed to create the init argument for the request

config = {}

Base init for fetch requests, use for things like api key headers which need to be the same on every request.


Maps all provided verbs to the method returned by createMethod, returns an object of schema { [verb]: method }.


Same as above

opts = {}

Same as above


Same as above


The verbs to create methods for, defaults to the list in http.json, which is also the list provided by the node http module.


Same as createAll above except the returned object also contains the HTTPErrors object.

HTTP Errors

The HttpErrors object contains a set of custom errors based on HTTP status codes, they extend the usual JS Error type but also include a status code and name e.g. status 400 name BadRequest.

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.