http-errors-js v1.0.2

HTTP Errors JS

The intent of this project is to generate errors that are suitable for use in HTTP applications. They are provided in such a way that they can be thrown without needing to know about the https status code at the non HTTP level.

Example Usage

An example use is in an express project:

import { Request, Response, NextFunction } from 'express';
import { NotFoundError }  from 'http-errors-js';

function handleGet(req: Request, res: Response, next: NextFunction) {
  try {
    throw new NotFoundError('Could not find resource');
  } catch (error) {
      next(error);
  }
}

Then with an express error handler:

import { Request, Response, NextFunction } from 'express';

function handleError(error: Error, req: Request, res: Response, next: NextFunction) {
  let httpStatus = 500;
  let message = error.message;

  if ((error as any).httpStatusCode) {
    httpStatus = (error as any).httpStatusCode;
    message = error.message;
  }

  res.status(httpStatus).json({
    status: httpStatus,
    message: message
  });
}

app.use(handleError);

Note, while the example are in Typescript, this work in plain old Javscript too, just without the types.

Adding New Errors

To add a new error type:

• update the errors.tsv file in the generator with new error.
• Run npm run generate.
• Run npm run build to finish up and create the dist files.

If everything proceeded properly, then you should find the new error file was generated and also referenced in the index file.

Contributions

Contributions and feedback are welcome. Please create a ticket first, before contributing any code.

License

This code is license using the MIT license.