Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mamsoudi/merror
A REST-friendly Express Middleware for HTTP error handling
https://github.com/mamsoudi/merror
error-handling error-messages express express-middleware expressjs nodejs
Last synced: 8 days ago
JSON representation
A REST-friendly Express Middleware for HTTP error handling
- Host: GitHub
- URL: https://github.com/mamsoudi/merror
- Owner: mamsoudi
- License: mit
- Created: 2017-12-31T17:24:31.000Z (over 6 years ago)
- Default Branch: develop
- Last Pushed: 2022-12-07T11:14:32.000Z (almost 2 years ago)
- Last Synced: 2024-04-25T22:02:10.236Z (5 months ago)
- Topics: error-handling, error-messages, express, express-middleware, expressjs, nodejs
- Language: TypeScript
- Homepage: http://masoudmirzaei.ir/merror
- Size: 389 KB
- Stars: 29
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-express - Merror - A RESTful-friendly Express Middleware for HTTP error handling and error responses (Middleware)
README
[](https://travis-ci.org/mamsoudi/merror) [](https://www.bithound.io/github/mamsoudi/merror/master/dependencies/npm) [](https://www.bithound.io/github/mamsoudi/merror/master/dependencies/npm) [](https://www.bithound.io/github/mamsoudi/merror) [](https://www.bithound.io/github/mamsoudi/merror)
# Merror
Developing REST APIs with Express, I was always looking for a clean way to send HTTP error responses along with the data I wanted, not only to allow clients to know which error has happened but to provide the information I wanted.
Express allows you to handle errors but doesn't return Error objects yet renders pages containing error information which is not so useful when developing REST APIs. Error information should be sent to the clients in JSON format so that they can process it and show it to users. So....
Here's Merror (/ˈmɪrə/). A simple wrapper around JavaScript Error objects with a middleware for Expressjs. Merror allows you to define a new HttpError object when you need in your controller. The object then will be passed to the middleware to be processed and sent to the client.
## Usage
Using Merror is easy and straight-forward. Install `express-merror` using NPM or Yarn and import `Merror` and `MerrorMiddlware` in your application.
```bash
$ npm install --save express-merror
```
```js
// If using TypeScript and ES6:
import { Merror, MerrorMiddleware } from 'express-merror';
// If using JS/RequireJS
const MerrorModule = require('express-merror');
const Merror = MerrorModule.Merror;
const MerrorMiddleware = MerrorModule.MerrorMiddleware;
```
Register `MerrorMiddleware` in your Expressjs application as a middleware **after registering router module** and start constructing Merror Objects whenever you hit an error in your controllers. Let's see an example:
```js
const express = require("express");
const cors = require("cors");
const app = express();
const router = express.Router();
// Some other middleware
app.use(cors());
// Register Routing Module
app.use("/", router);
// Router
router.post("/profile", function(req, res) {
// Pay attention that we should wrap our error object
// with next() in order to make it travel to our middleware
// which is registered after router module
return next(new Merror(401, "Unauthorized Access! Custom Message!", {code: 1001,status: "REFRESH_TOKEN"} ));
});
// Merror Middleware
app.use(MerrorMiddleware());
// Router Module
app.listen(3000, () => console.log("Example app listening on port 3000!"));
```
If we make a request to `http://localhost:3000/profile` we will see this in the body of the response:
```JSON
{
"success": false,
"statusCode": 401,
"error": "Unauthorized",
"message": "Unauthorized Access!",
"properties": {
"code": 1001,
"status": "REFRESH_TOKEN"
}
}
```
> _**NOTE:**_
> Please pay attention that you should register the middleware after registering routes and also wrap constructed error with next() function and return it in order for Merror to work properly.
## API
### `new Merror(statusCode, message, [properties])`
Creates a new `Merror` object with given `statusCode` and `message`. You're free to take control of what you pass as `properties` it will be included in the response.
```js
app.post("/login", function(req, res) {
return next(new Merror(500, "Internal Server Error", {code: 1021,status: "USER_NOT_FOUND"} ));
});
```
Assuming we have [`express-validator`](https://github.com/ctavan/express-validator) middleware in our application we can do this:
```js
app.post("/login", function(req, res) {
req.assert("email", "Provided email is not correct").isEmail().notEmpty();
req.assert("password", "Password is not valid").isLength({ min: 8 }).notEmpty();
const errors = req.validationErrors(true);
if (errors) {
return next(new Merror(403, "Authentication Failed. Invalid Email or Password.", errors));
}
// Rest of our code to find user, etc.
});
```
Now if we POST an invalid email to this route we can see this in the response:
```JSON
{
"success": false,
"statusCode": 403,
"error": "Forbidden",
"message": "Authentication Failed. Invalid Email or Password.",
"properties": {
"email": {
"location": "body",
"param": "email",
"msg": "Provided email is not correct",
"value": false
}
}
}
```
### `MerrorMiddleware()`
Returns a simple handler that takes errors constructed in our router and sends a response with corresponding `statusCode`, `message` and `properties` if provided.
```js
// Router Module
app.get('/', (req, res) => next(new Merror(404, "Not Found!")))
// Register Middleware here after all routes
app.use(MerrorMiddleware());
```
## License
This project is licensed under MIT. Feel free to fork, change and use it however you like.
## Contribution
If you feel there's something that could be better in this module make sure to fork, make changes and make a new PR with full description of what you've changed. I'll make sure to review it.