fetch-with-status

0.0.8 • Public • Published

fetch-with-status

fetch with status helpers.

A small lib so you remember to check the status code of your request.

npm version

Installation

npm install fetch-with-status

yarn add fetch-with-status

example

const {withStatus} = require('fetch-with-status')
 
withStatus(fetch('https://jsonplaceholder.typicode.com/posts/1'))
  .when(200, (request) =>
    request.json())
  .when([404, 405], (request) =>
    throw new Error('Oh no!'))
  .build()
  .then((json) =>
    console.log(json))
  .catch((error) =>
    console.log('error', error.message))

Summary

API

when

Takes a number | array of numbers and a function.

What gets returned from executed .when get passed to original promise chain after execution.

Syntax

  .when(206, (request, next) => {})
 
  .when([206, 500], (request, next) => {})

Parameters

  • number || Array of numbers: desired status code:s
  • function:
    • params:
      • response: fetch response object
      • next: call next() if you want to continue to the standard .then promise chain
    • returns: any

Return value

self so we can chain multible .when

Build

Syntax

  .build()

Parameters

none

Return value

Promise: originl fetch promise

Usage

// Require it like this
const {withStatus} = require('fetch-with-status')
 
// Wrap your fetch with the `withStatus` function
withStatus(fetch(/*URL*/))
  // then add all the status handlers you want
  // the full request object is returned in all handlers
  .when(200, (request, next) => {
    console.log('we got an 206 response')
    // if you want to continue down the promise chain call 'next'
    // and your value will be passed down to the first .then
    next(request.json())
  })
 
  .when([404, 405, 406], (request) => {
    // here we don't call next because we don't want to continue down the promise chain
    console.log('we got an 404, 405 or 406 response')
  })
  // after you added all your desired handlers call .build
  .build()
  // now we have the original promise so we can add .then:s and a .catch
  .then(() => {
    // only request with handlers that call 'next' appear here
  })
  .catch((error) => {
 
  })

TODO:

  • make stuff immutable (more fp)
  • tests

Package Sidebar

Install

npm i fetch-with-status

Weekly Downloads

2

Version

0.0.8

License

ISC

Last publish

Collaborators

  • richie_south