signal-exit

What is signal-exit?

The signal-exit package is used to capture and handle events that indicate Node.js process is about to exit. This includes handling of signals like SIGINT and SIGTERM, as well as normal process termination. It allows developers to register callbacks that can perform cleanup or other final actions before the process exits.

What are signal-exit's main functionalities?

Capture exit events

This feature allows you to capture any kind of exit, whether it's due to a signal or a normal exit. The callback function is called with the exit code and the signal that caused the exit, if applicable.

const onExit = require('signal-exit');

const removeExitHandler = onExit(function (code, signal) {
  console.log('Process is exiting with code:', code, 'and signal:', signal);
});

// Later, if you decide you do not want to handle the exit:
removeExitHandler();

Unregister exit handler

This feature allows you to unregister a previously registered exit handler. This is useful if the exit handling logic is no longer needed, or if you want to replace it with a different handler.

const onExit = require('signal-exit');

const removeExitHandler = onExit(function () {
  // cleanup logic here
});

// When you no longer need to handle exits:
removeExitHandler();

Other packages similar to signal-exit

exit-hook

The exit-hook package provides similar functionality to signal-exit, allowing developers to register callbacks that are executed when the process exits. It also captures uncaught exceptions and unhandled promise rejections. Compared to signal-exit, exit-hook may offer a simpler API but might not handle all the edge cases that signal-exit does.

async-exit-hook

async-exit-hook is another package that allows you to run asynchronous code when the process exits. It is similar to signal-exit but focuses on supporting asynchronous operations during the exit handling. This can be particularly useful for ensuring that database connections are closed or files are written before the process terminates.

death

The death package (also known as DEATH on npm) is a simple utility to make handling UNIX signals and uncaught exceptions in Node.js easier. It provides a straightforward way to clean up after your script without much fuss. Compared to signal-exit, death has a more focused scope and does not handle normal process termination.

README

signal-exit

When you want to fire an event no matter how a process exits:

• reaching the end of execution.
• explicitly having process.exit(code) called.
• having process.kill(pid, sig) called.
• receiving a fatal signal from outside the process

Use signal-exit.

var onExit = require('signal-exit')

onExit(function (code, signal) {
  console.log('process exited!')
})

API

var remove = onExit(function (code, signal) {}, options)

The return value of the function is a function that will remove the handler.

Note that the function only fires for signals if the signal would cause the proces to exit. That is, there are no other listeners, and it is a fatal signal.

Options

• alwaysLast: Run this handler after any other signal or exit handlers. This causes process.emit to be monkeypatched.