https://github.com/abernier/uest
https://github.com/abernier/uest
Last synced: 7 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/abernier/uest
- Owner: abernier
- Created: 2019-12-26T15:44:46.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-01-05T03:42:38.000Z (almost 3 years ago)
- Last Synced: 2025-04-06T11:09:49.693Z (7 months ago)
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/uest
- Size: 303 KB
- Stars: 9
- Watchers: 1
- Forks: 1
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://github.com/abernier/uest/actions?query=workflow%3Aci%2Fcd)
[](https://www.npmjs.com/package/uest)
[](https://coveralls.io/github/abernier/uest)
`req.uest` is an Express middleware that allows you, from a given route, to request another route.
Features are:
- Initial `req` cookies are passed along to subsequent `req.uest`s
- Cookies set by `req.uest`s responses are forwarded to initial `res`
- `req.session` stay in sync between requests
It allows you to decouple your app's routes from your API's ones. IOW, your app routes can now consume your API as any client.
## Install
```
$ npm i uest
```
```js
// app.js
const uest = require('uest')
app.use(uest())
```
## Usage
```js
req.uest(options, (er, resp, body) => {})
```
- `options` -- are the same as [request/request](https://github.com/request/request#requestoptions-callback), with defaults to `json: true` and `baseUrl` to the same as your Express server.
- `resp` -- the response object, see: [http.IncomingMessage](https://nodejs.org/api/http.html#http_class_http_incomingmessage)
- **`resp.body`** holds the JSON response datas
- `er` -- when an error occurs or `resp.statusCode >= 400`, see: [http.ClientRequest](http://nodejs.org/api/http.html#http_class_http_clientrequest)
- **`er.status`** holds the response statusCode, for example: `404` or `409`...
It also supports `await`:
```
const [resp, body] = await req.uest(options)
```
## Example
```js
// Mount our API router
app.use('/api', require('./routers/api'));
//
// App routing
//
app.post('/login', (req, res, next) => {
const {email, password} = req.body
//
// Our subsequent request to `POST /api/sessions` route
//
req.uest({
method: 'POST',
url: '/api/sessions',
body: {email, password}
}, (er, resp, body) => {
if (er) {
// Deal with specific "Forbidden" error
if (er.status === 403) {
return res.render('login', {error: "Wrong login/password"})
}
return next(er); // for any other error
}
console.log('User-session created for', body.user)
// `req.session` is up-to-date
console.log(`Welcome back ${req.session.user.firstname}!`
res.redirect('/profile')
})
});
```