https://github.com/s2thend/express-http-client
A light-weight javascript http request library built in conscious of middleware design pattern. (requires fetch api)
https://github.com/s2thend/express-http-client
auth0 authentication axios expressjs http-client http-requests httpclient imperative-programming interceptor-http logger-middleware middleware refresh-token token
Last synced: 29 days ago
JSON representation
A light-weight javascript http request library built in conscious of middleware design pattern. (requires fetch api)
- Host: GitHub
- URL: https://github.com/s2thend/express-http-client
- Owner: S2thend
- License: mit
- Created: 2025-05-06T08:14:16.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-05-14T05:11:47.000Z (11 months ago)
- Last Synced: 2025-06-16T10:56:34.962Z (10 months ago)
- Topics: auth0, authentication, axios, expressjs, http-client, http-requests, httpclient, imperative-programming, interceptor-http, logger-middleware, middleware, refresh-token, token
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/express-http-client
- Size: 34.2 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Express Http Client
[](https://www.npmjs.com/package/express-http-client)
[](https://shields.io/)
[](https://shields.io/)
[](https://shields.io/)
[](https://shields.io/)
[](code_of_conduct.md)
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
```js
import { request } from 'express-http-client';
await request(
"https://example.com/api/v1/posts",
{
method: 'GET',
headers: {
'Authorization': 'Bearer ' + refresh
}
},
// response interceptors
[
//example response interceptor middleware
(data, next) => {
data.response.json().then(json => {
console.log(json);
next();
}).catch(error => {
next(error);
});
}
],
// request interceptors
[]
);
```
### httpClient
```js
import {httpClient as expressHttpClient, logger, mockResponse} from 'express-http-client';
//create a new http client instance, you can create multiple http client instance for different purpose
let httpClient = expressHttpClient();
//add request interceptor middleware: example to add authorization header
httpClient.addRequestInterceptor(async (data, next) => {
data.request = new Request(data.request, {
// You can override any request properties here
headers: new Headers({
...Object.fromEntries(data.request.headers.entries()),
'Authorization': `Bearer token`
}),
});
next();
});
//add response interceptor middleware: example
httpClient.addResponseInterceptor(
//use built in logger interceptor middleware to log the request and response
logger(),
);
httpClient = httpClient.create("replace with your base url");
let 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
```js
import {httpClient as expressHttpClient, logger, mockResponse} from 'express-http-client';
let httpClient = expressHttpClient();
httpClient.addResponseInterceptor(
mockResponse(
true,
// supply the mock response mapping object here(url.method -> response)
{
"http://example.com/api/v1/posts": {
//mock response for GET request
"GET": ()=> new Response(JSON.stringify(
//mock response data
))
},
"http://example.com/api/v1/posts": {
//mock response for all request
"ALL": ()=> new Response(JSON.stringify(
//mock response data
))
},
}
)
)
```