react-native-bulletproof-httpclient

A bulletproof wrapper around the axios client for react-native which takes as an argument a mapping of http response status code to handling function, with a mandatory default handler for unexpected codes

This is a WIP and is not production ready yet; it has only been published in order to reserve the package name on npm... use at your own risk

Get Started

Installation

$ npm install --save react-native-bulletproof-httpclient

Usage:

Assume a particular HTTP endpoint in your API is expected to respond only with the following response status codes: 200, 204, 400, 401, or 500

import { POST } from 'react-native-bulletproof-httpclient';

async makeRequest(url, config, body) {
	await POST(
		url,
		body,
		config, // headers and params
		{
			200: async resp => {
				// handle 200/OK
			},
			204: async resp => {
				// handle 204/NoContent
			},
			400: async resp => {
				// handle 400/BadRequest
			},
			401: async resp => {
				// handle 401/Unauthorized
			},
			500: async resp => {
				// handle 500/InternalServerError
			},
			'default': async resp => {
				// handle unexpected status code
			}
		}
	);
}

Or if you prefer to use properly defined functions, or if you wish to reuse the same handling function with multiple response status codes...

import { POST } from 'react-native-bulletproof-httpclient';

async handleStatusOK(resp) {
	// handle 200/OK
}

async handleStatusNoContent(resp) {
	// handle 204/NoContent
}

async handleStatusBadRequest(resp) {
	// handle 400/BadRequest
}

async handleStatusUnauthorized(resp) {
	// handle 401/Unauthorized
}

async handleStatusInternalServerError(resp) {
	// handle 500/InternalServerError
}

async handleUnexpectedStatusCode(resp) {
	// handle unexpected status code
}

async makeRequest(url, config, body) {
	await POST(
		url,
		body,
		config,
		{
			200: this.handleStatusOK,
			204: this.handleStatusNoContent,
			400: this.handleStatusBadRequest,
			401: this.handleStatusUnauthorized,
			500: this.handleStatusInternalServerError,
			'default': this.handleUnexpectedStatusCode
		}
	);
}