Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



13 Commits

Repository files navigation


BadRequestError is a custom error constructor for HTTP errors (bad parameters, forbidden, unauthorized…). It takes an error message as first parameter and optionally a HTTP error code as second parameter (defaults to 400).


It requires at least Node V6 as it uses JavaScript classes.

npm install --save bad-request-error


In addition to the native Error constructor properties, BadRequestError adds httpStatus and has its name property set to BadRequestError.

const BadRequestError = require('bad-request-error');

async function addComment(req, res) {
    await const isCorrectPasswd = checkPasswd(req);
    if (!isCorrectPasswd) return throw new BadRequestError('Your password looks wrong', 401);

    // whatever you have to do if password is correct

It's very convenient to use it with an error handler function like the following:

// /lib/handleError.js

 * Send client err if it's validation error or log if it's a native or low level error
 * @param { Object } err error object
 * @param { Object } res
function handleError(err, res) {
    // send errmsg to user if it's a BadRequestError
    if (res && && === 'BadRequestError') {
        res.status(err.httpStatus).json({ error: err.message });

    // send http err if res object is provided
    if (res) res.status(500).send('Server Error');

    // if it's more low level, or if errorField isn't an error's propt
    console.error(err); // or custom logger like winston

module.exports = handleError;

If using promises, the error is easily handled in a catch block.

const BadRequestError = require('bad-request-error');
const handleError = require('/lib/handleError');

// this function return a promise with the same BadRequestError as above if password doesn't match
// BadRequestError('Your password looks wrong', 401);
function checkPasswd(passwd) {}

function addComment(req, res) {
    .then(() => {
        // whatever you have to do if password is correct
    .catch(err => handleError(err, res));


There's sure room for improvement, so feel free to hack around and submit PRs! Please just follow the style of the existing code, which is Airbnb's style with minor modifications.

To maintain things clear and visual, please follow the git commit template.