awarejs

所属分类:Node.js
开发工具:HTML
文件大小:70KB
下载次数:0
上传日期:2021-05-12 01:03:04
上 传 者sh-1993
说明:  只要NodeJS应用程序内部发生错误,就可以通过带有堆栈跟踪的电子邮件轻松触发通知。
(An easy way to trigger notifications via emails with stack trace whenever an error occurs inside a Node JS Application.)

文件列表:
LICENSE (1070, 2019-06-30)
awarejs-example.png (69525, 2019-06-30)
index.js (66, 2019-06-30)
package-lock.json (1185, 2019-06-30)
package.json (725, 2019-06-30)
src (0, 2019-06-30)
src\Aware.js (4186, 2019-06-30)
src\utilities (0, 2019-06-30)
src\utilities\helpers.js (366, 2019-06-30)
templates (0, 2019-06-30)
templates\default.ejs (18284, 2019-06-30)

## Aware JS - Node JS Error Notifications An easy way to send emails notifications with stack trace whenever an error occurs on the server for Node JS applications. ![awarejs example](https://github.com/humanzstudioz/awarejs/blob/master/awarejs-example.png?raw=true "AwareJS Example") ## Installation ### via npm ``` npm install awarejs --save ``` ## Usage - After installing, create an AwareJS class object and initialise it using these configurations. ``` let options = { mailer: { credentials: { // Node mailer initialization options host: 'smtp.mailtrap.io', port: '2525', secure: false, auth: { user: 'MAIL_USERNAME', pass: 'MAIL_PASSWORD', } }, config: { // Node mailer message configuration options to: 'someone@email.com', from: 'noreply@email.com', }, }, params: { footer: { unsubscribe: { link: 'LINK_TO_UNSUBSCRIBE_ELSE_NULL', } } }, debug: true, // prints console.log() wherever needed to debug the issue }; const aware = new Aware(options); const errorObj = new Error('Hello World Test Error'); aware.setError(errorObj); aware.trigger(); // aware.trigger([ { name: 'URL', value: 'https://someurl.com' } ]); with extra info to include at last of the email. ``` ## Available Methods | Method Name | Description | Required | | ------- | :--------------:| -------- | | **setError(errorObj)** | *This method takes in the error object which consumes the error and extract required information from it. It also prepares error data to be triggered via email.* | Yes | | **setupMailer(setMailerConfig)** | *This method takes in the credentials for Nodemailer to initialize it. Check [NodeMailer Docs](https://github.com/humanzstudioz/awarejs/blob/master/https://nodemailer.com/) for setting up the mail client. You can also pass `mailer.credentials` in constructor object to initialize it while object creation* | Optional | | **setMailerConfig(config)** | *This method takes in the message configurations defined in [NodeMailer Message Docs](https://github.com/humanzstudioz/awarejs/blob/master/https://nodemailer.com/message/). You can also pass `mailer.config` in constructor object to initialize it while object creation* | Optional | | **setDontReportErrors(errorNamesArr)** | *This method takes in an array of error names (as in `error.constructor.name`) and makes sure that names inside this array should be neglected for triggering out the emails/notifications to* | Optional | | **trigger(extraInfo)** | *This method takes in an array of objects (e.g.: `[ { name: 'URL', value: 'https://someurl.com' } ]`) which could be added as an extra information at the end of the email* | Yes | | **test(extraInfo)** | *This method can be used to test the working of this module. After executing this method you should receive a test email to make sure everything is working fine.* | Optional | ## Security If you find any security related issue, please email saumya.rastogi04@gmail.com instead of using the issue tracker. # License The MIT License. Please see [License File](https://github.com/humanzstudioz/awarejs/blob/master/LICENSE.md) for more information.

近期下载者

相关文件


收藏者