rest-error-handler

This project defines error formats of RESTful APIs. By following my guideline, one's APIs will be consistent to RESTful standards. This project is in its very early experimental stage, thus it is highly recommended not to implement in production.

At the moment only three types of errors have formalised: 401, 403, 404, 422 and 500.

Installation

rest-error-handler is available as an npm package.

``sh
yarn add rest-error-handler
npm install --save rest-error-handler
`

Docs

$3

`javascript
// index.js
import express from 'express';
import restErrorHandler from 'rest-error-handler';

import login from './login.js';

const app = express();
app.get('/login', login);
app.use(restErrorHandler());
`

$3

`javascript
// login.js
export default function(req, res, next) {
const {
username,
} = req.query;

if (username === void 0) {
const err = new Error('Unprocessable Entity');
err.status = 422; // HTTP status code 422
err.details = [{
code: 'invalid',
field: 'username', // Declare which field is required
resource: 'Login',
}];
return next(err);
}

if (username !== 'correct name') {
const err = new Error();
err.status = 401; // HTTP status code 401
return next(err);
}

res.send('you are logged in');
}
``