
Research
Security News
The Growing Risk of Malicious Browser Extensions
Socket researchers uncover how browser extensions in trusted stores are used to hijack sessions, redirect traffic, and manipulate user behavior.
log-process-errors
Advanced tools
The log-process-errors npm package is designed to automatically log and handle process errors in Node.js applications. It provides a simple and consistent way to manage errors such as uncaught exceptions, unhandled promise rejections, and other process-level errors, making debugging and monitoring easier.
Automatic Error Logging
This feature automatically logs uncaught exceptions, unhandled promise rejections, and other process errors to the console or a specified logging service. By simply requiring and invoking the package, it starts monitoring and logging errors without additional configuration.
const logProcessErrors = require('log-process-errors');
logProcessErrors();
Custom Error Handlers
Allows you to define custom error handlers for different types of process errors. This example shows how to log a custom message for each error event.
const logProcessErrors = require('log-process-errors');
logProcessErrors({
onError(error, event, originalError) {
console.error(`Custom handler: ${event} - ${error.message}`);
}
});
Integration with Logging Services
This feature allows integration with various logging services like Winston, Bunyan, or any other logging library. The example demonstrates how to use Winston to log process errors.
const logProcessErrors = require('log-process-errors');
const winston = require('winston');
const logger = winston.createLogger({
transports: [
new winston.transports.Console()
]
});
logProcessErrors({
onError(error, event, originalError) {
logger.error(`${event} - ${error.message}`);
}
});
Winston is a versatile logging library for Node.js that allows you to log messages to various transports (console, file, etc.). While it does not specifically handle process errors out of the box, it can be configured to log such errors with custom handlers.
Bunyan is another logging library for Node.js that provides a simple and fast JSON logging solution. Similar to Winston, it does not automatically handle process errors but can be used in conjunction with custom error handlers to log such errors.
Pino is a fast and low-overhead logging library for Node.js. It focuses on performance and can be used to log process errors by setting up custom error handlers. It does not provide automatic process error handling like log-process-errors.
Show some ❤️ to Node.js process errors.
This improves process errors: uncaught exceptions, unhandled promises, promises handled too late and warnings.
rejectionHandled
Production code (e.g. a server) can install this either as a production or development dependency:
npm install log-process-errors
However, libraries should install this as a development dependency:
npm install -D log-process-errors
This is because logging is modified globally and libraries users might not expect this side-effect. Also, this might lead to conflicts between libraries.
This package works in Node.js >=18.18.0.
This is an ES module. It must be loaded using
an import
or import()
statement,
not require()
. If TypeScript is used, it must be configured to
output ES modules,
not CommonJS.
options
object?
Return value: () => void
Start handling process errors.
import logProcessErrors from 'log-process-errors'
logProcessErrors(options)
The return value restores Node.js default behavior.
const restore = logProcessErrors(options)
restore()
Type: boolean
Whether to exit the process on uncaught exceptions or unhandled promises.
This is false
by default if other libraries are listening to those events, so
they can perform the exit instead. Otherwise, this is true
.
If some tasks are still ongoing, the exit waits for them to complete up to 3 seconds.
Type: (error, event) => Promise<void> | void
Default: console.error(error)
Function called once per process error. Duplicate process errors are ignored.
// Log process errors with Winston instead
logProcessErrors({
onError: (error, event) => {
winstonLogger.error(error.stack)
},
})
Type: Error
The process error. This is guaranteed to be a normalized error instance. A short description of the event is also appended to its message.
Type: Event
Process event name among:
'uncaughtException'
,
'unhandledRejection'
,
'rejectionHandled'
,
'warning'
.
modern-errors
: Handle errors in
a simple, stable, consistent waymodern-errors-process
:
Handle process errorserror-custom-class
: Create
one error classerror-class-utils
: Utilities
to properly create error classeserror-serializer
: Convert
errors to/from plain objectsnormalize-exception
:
Normalize exceptions/errorsis-error-instance
: Check if
a value is an Error
instancemerge-error-cause
: Merge an
error with its cause
set-error-class
: Properly
update an error's classset-error-message
: Properly
update an error's messagewrap-error-message
:
Properly wrap an error's messageset-error-props
: Properly
update an error's propertiesset-error-stack
: Properly
update an error's stackerror-cause-polyfill
:
Polyfill error.cause
handle-cli-error
: 💣 Error
handler for CLI applications 💥error-http-response
:
Create HTTP error responseswinston-error-format
: Log
errors with WinstonFor any question, don't hesitate to submit an issue on GitHub.
Everyone is welcome regardless of personal background. We enforce a Code of conduct in order to promote a positive and inclusive environment.
This project was made with ❤️. The simplest way to give back is by starring and sharing it online.
If the documentation is unclear or has a typo, please click on the page's Edit
button (pencil icon) and suggest a correction.
If you would like to help us fix a bug or add a new feature, please check our guidelines. Pull requests are welcome!
Thanks go to our wonderful contributors:
ehmicky 💻 🎨 🤔 📖 | Steven Vachon 💬 | Hongarc 📖 💻 | Andy Brenneke 🐛 |
FAQs
Show some ❤️ to process errors
The npm package log-process-errors receives a total of 126,688 weekly downloads. As such, log-process-errors popularity was classified as popular.
We found that log-process-errors demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Socket researchers uncover how browser extensions in trusted stores are used to hijack sessions, redirect traffic, and manipulate user behavior.
Research
Security News
An in-depth analysis of credential stealers, crypto drainers, cryptojackers, and clipboard hijackers abusing open source package registries to compromise Web3 development environments.
Security News
pnpm 10.12.1 introduces a global virtual store for faster installs and new options for managing dependencies with version catalogs.