An http exception library
npm install http-exception> HttpException is a small, easy-to-use, and dependency-free HTTP error library for Node.
(Exceptions vs Errors)[https://nodejs.org/api/errors.html#errors_exceptions_vs_errors]
HttpException improves the error handling experience while matching the
familiar JavaScript native Error object API. It comes with support for creating
custom error objects and with sensible defaults. Use the available HTTP status
code functions to create status-specific errors. All status codes included in
Node's http moddule are supported.
(Node's http module)[https://nodejs.org/api/http.html]
* Familiar native Error API
* Small size (~2 KB)
* No third-party dependencies
* Uses Node's http module's status codes
* Well-tested
Using npm:
``
npm install --save http-exception
Once installed, import and use:
`
const HttpException = require('http-exception')
// via the HttpException class
const errorOne = new HttpException()
// via the createError factory
const errorTwo = HttpException.createError()
// via HttpException's static HTTP methods
const errorThree = HttpException.internalServerError()
throw errorOne
`
* message { String }
Creates a new HttpException object with the supplied message.
* options { Object }
Returns an instance of HttpException with the supplied properties.
* message { String }
Returns an instance of HttpException with the supplied message.
HttpException is still a work in progress. Although a well-tested basic level
of functionality is available now, a list of outstanding items and features to
complete is below:
1. Implement a standard mechanism to add custom static exception methods.
2. Consider enabling the customization/initialization of the error objects returned by
HttpException.
3. Consider exposing elements of status`.
4. Consider making the library isomorphic.
5. Write tests for stack trace filtering.
Have a bug or feature request? (Please open a new issue)[https://github.com/vedb/http-exception/issues/new]