Gathering detailed insights and metrics for @chenhongqiao/fastify-http-errors-enhanced
Gathering detailed insights and metrics for @chenhongqiao/fastify-http-errors-enhanced
A error handling plugin for Fastify that uses enhanced HTTP errors.
Installations
npm install @chenhongqiao/fastify-http-errors-enhancedDeveloper Guide
BETA
Typescript
Yes
Module System
ESM
Min. Node Version
>=14.15.0
Score
70.3
Supply Chain
99.3
Quality
74.6
Maintenance
100
Vulnerability
99.6
License
Releases
Unable to fetch releases
Languages
2
TypeScript
JavaScript
TypeScript (99.72%)
JavaScript (0.28%)
🚀 npmpackage.info for sale
Built with Next.js • Fully responsive • SEO optimized • Open source ready
Developer
Download Statistics
Total Downloads
550
Last Day
2
Last Week
6
Last Month
25
Last Year
195
GitHub Statistics
ISC License
154 Commits
1 Branches
1 Contributors
Updated on Feb 05, 2023
Maintainers
1
Package Meta Information
Latest Version
4.1.0
Package Id
@chenhongqiao/fastify-http-errors-enhanced@4.1.0
Unpacked Size
31.75 kB
Size
9.79 kB
File Count
16
Published on
Jun 23, 2023
Total Downloads
Cumulative downloads
Total Downloads
550
Last Day
0%
2
Compared to previous day
Last Week
50%
6
Compared to previous week
Last Month
47.1%
25
Compared to previous month
Last Year
-15.2%
195
Compared to previous year
Weekly Downloads
Monthly Downloads
Yearly Downloads
fastify-http-errors-enhanced
A error handling plugin for Fastify that uses enhanced HTTP errors.
http://sw.cowtech.it/fastify-http-errors-enhanced
Installation
Just run:
1npm install fastify-http-errors-enhanced --save
Usage
Register as a plugin, optional providing any of the following options:
handle404Errors: If to set an handler viasetNotFoundHandler.hideUnhandledErrors: If to hide unhandled server errors or returning to the client including stack information. Default is to hide errors whenNODE_ENVenvironment variable isproduction.convertValidationErrors: Convert validation errors to a structured human readable object. Default istrue.convertResponsesValidationErrors: Convert response validation errors to a structured human readable object. Default is to enable whenNODE_ENVenvironment variable is different fromproduction.allowUndeclaredResponses: When converting response validation errors, allow responses that have no schema defined instead of throwing an error.responseValidatorCustomizer: A function that receives a Ajv instances before compiling all response schemas. This can be used to add custom keywords, formats and so on.preHandler: A function invoked before the error handlers that can modify the original error thrown. The function must accept the error as first argument and return the error to process.
Once registered, the server will use the plugin handlers for all errors (basically, both setErrorHandler and setNotFoundHandler are called).
The handler response format will compatible with standard fastify error response, which is the following:
1{ 2 statusCode: number 3 error: string 4 message: string 5}
If the original error's code properties does not start with HTTP_ERROR_ (http-errors-enhanced standard error prefix), then the code is also included in output object.
In addition, the response headers will contain all headers defined in error.headers and the response body will contain all additional enumerable properties of the error.
To clarify, take this server as a example:
1import fastify from 'fastify' 2import fastifyHttpErrorsEnhanced from 'fastify-http-errors-enhanced' 3import { NotFoundError } from 'http-errors-enhanced' 4 5const server = fastify() 6 7/* 8Since fastify-http-errors-enhanced uses an onRoute hook, you have to either: 9 10* use `await register...` 11* wrap you routes definitions in a plugin 12 13See: https://www.fastify.io/docs/latest/Guides/Migration-Guide-V4/#synchronous-route-definitions 14*/ 15await server.register(fastifyHttpErrorsEnhanced) 16 17server.get('/invalid', { 18 handler: async function (request, reply) { 19 throw new NotFoundError('You are not supposed to reach this.', { 20 header: { 'X-Req-Id': request.id, id: 123 }, 21 code: 'UNREACHABLE' 22 }) 23 } 24}) 25 26server.listen({ port: 3000 }, err => { 27 if (err) { 28 throw err 29 } 30})
When hitting /invalid it will return the following:
1{ 2 "error": "Not Found", 3 "code": "UNREACHABLE", 4 "message": "You are not supposed to reach this.", 5 "statusCode": 404, 6 "id": 123 7}
and the X-Req-Id will be set accordingly.
Unhandled error handling
Once installed the plugin will also manage unhandled server errors.
In particular, if error hiding is enabled, all unhandled errors will return the following response:
1{ 2 "error": "Internal Server Error", 3 "message": "An error occurred trying to process your request.", 4 "statusCode": 500 5}
and the error will be logged using error severity.
If not hidden, instead, the error will be returned in a standard response that also add the stack property (as a array of strings) and any additional error enumerable property.
To clarify, take this server as a example:
1import fastify from 'fastify' 2import fastifyHttpErrorsEnhanced from 'fastify-http-errors-enhanced' 3import { NotFoundError } from 'http-errors-enhanced' 4import createError from 'http-errors' 5 6await server.register(fastifyHttpErrorsEnhanced, { hideUnhandledErrors: false }) 7 8server.get('/invalid', { 9 handler(request, reply) { 10 const error = new Error('This was not supposed to happen.') 11 error.id = 123 12 throw error 13 } 14}) 15 16server.listen({ port: 3000 }, err => { 17 if (err) { 18 throw err 19 } 20})
When hitting /invalid it will return the following:
1{ 2 "error": "Internal Server Error", 3 "message": "[Error] This was not supposed to happen.", 4 "statusCode": 500, 5 "id": 123, 6 "stack": ["..."] 7}
Validation and response validation errors
If enabled, response will have status of 400 or 500 (depending on whether the request or response validation failed) and the the body will have the failedValidations property.
Example of a client validation error:
1{ 2 "statusCode": 400, 3 "error": "Bad Request", 4 "message": "One or more validations failed trying to process your request.", 5 "failedValidations": { "query": { "val": "must match pattern \"ab{2}c\"", "val2": "is not a valid property" } } 6}
Example of a response validation error:
1{ 2 "error": "Internal Server Error", 3 "message": "The response returned from the endpoint violates its specification for the HTTP status 200.", 4 "statusCode": 500, 5 "failedValidations": { 6 "response": { 7 "a": "must be a string", 8 "b": "must be present", 9 "c": "is not a valid property" 10 } 11 } 12}
ESM Only
This package only supports to be directly imported in a ESM context.
For informations on how to use it in a CommonJS context, please check this page.
Contributing to fastify-http-errors-enhanced
- Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
- Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
- Fork the project.
- Start a feature/bugfix branch.
- Commit and push until you are happy with your contribution.
- Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
Copyright
Copyright (C) 2019 and above Shogun (shogun@cowtech.it).
Licensed under the ISC license, which can be found at https://choosealicense.com/licenses/isc.
No vulnerabilities found.