Build clases for handling errors defined in a JSON file for the proton-koa microframework. This is the json structure that represents the error group for users:
The first level of the object represents the possible errors (code error), except for the
opts field. This field allows you to add settings for the class to be built. So far the options
className can be configured. If the
opts field is not specified, the following default will be set:
If the className field is not specified, the name of the file will be taken as the class name.
At the next level of the json structure, for each error a
description field must be defined that explains the error and a
status field that will be an HTTP status to respond to the query affected by error:
If some of these two fields is not defined, the fields defined in
opts.unknownError will be taken. If these are also not defined, the default fields of the quark will be taken.
Each built class is inserted as global. The classes will have as name, the name of the json file where their errors were defined.
To generate a new error, you must only create a new object of some of the classes and pass by parameter the error code and the native error (error object or string) that occurred:
throw 'notFound' 'This is native error.'
The method process
Also each class contains a static method called
process that receives by parameter the context of the request and the error. This allows you to configure the response of the request for a defined or unknown error.
trythrow 'notFound' 'this is native error.'catch errUserError
The process method responds to the request with the status defined according to the type of error and as body an object with the fields
The tasks will be defined in a function object in a file named
tasks.js located in the
errors folder. The names of the functions must be equal to the name of the error class to which it corresponds. The only parameter of these functions will always be an object with the body, the params and the query of the http request. The functions will keep the context of the class error. See the following example.
The tasks will be called at the end of the execution of the
More information in the test.