Express Http Client

A light-weight javascript http request library built in conscious of middleware design pattern. (requires fetch api)

This project aims to reduce user mental effort and give user more control over the request process by provide only minimal features.

The middleware usage is as intuitive as using expressjs server middleware by using next() to pass control to the next middleware.

It will minimize effort to migrate from fetch to this library and work out of the box by just simply rename fetch to request in your project.

Quick Start

one time request

1import { request } from 'express-http-client';
2
3await request(
4    "https://example.com/api/v1/posts",
5    {
6        method: 'GET',
7        headers: {
8            'Authorization': 'Bearer ' + refresh
9        }
10    },
11    // response interceptors
12    [
13        //example response interceptor middleware
14        (data, next) => {
15            data.response.json().then(json => {
16                console.log(json);
17                next();
18            }).catch(error => {
19                next(error);
20            });
21        }
22    ],
23    // request interceptors
24    []
25);

httpClient

1import {httpClient as expressHttpClient, logger, mockResponse} from 'express-http-client';
2
3//create a new http client instance, you can create multiple http client instance for different purpose
4let httpClient = expressHttpClient();
5
6//add request interceptor middleware: example to add authorization header
7httpClient.addRequestInterceptor(async (data, next) => {
8    data.request = new Request(data.request, {
9        // You can override any request properties here
10        headers: new Headers({
11            ...Object.fromEntries(data.request.headers.entries()),
12            'Authorization': `Bearer token`
13        }),
14    });
15    next();
16});
17
18//add response interceptor middleware: example
19httpClient.addResponseInterceptor(
20    //use built in logger interceptor middleware to log the request and response
21    logger(),
22);
23
24httpClient = httpClient.create("replace with your base url");
25
26let response = await httpClient.send(`/api/v1/posts`);

Api

interceptor function

parameters

• data: the data object
  • request: the request object
  • response: the response object
  • store: a map store for data persistence between interceptors
• next: the next function

built in interceptor functions

logger

mockResponse

1import {httpClient as expressHttpClient, logger, mockResponse} from 'express-http-client';
2
3let httpClient = expressHttpClient();
4
5httpClient.addResponseInterceptor(
6    mockResponse(
7        true,
8        // supply the mock response mapping object here(url.method -> response)
9        {
10            "http://example.com/api/v1/posts": {
11                //mock response for GET request
12                "GET": ()=> new Response(JSON.stringify(
13                    //mock response data
14                ))
15            },
16            "http://example.com/api/v1/posts": {
17                //mock response for all request
18                "ALL": ()=> new Response(JSON.stringify(
19                    //mock response data
20                ))
21            },
22        }
23    )
24)