util: process signal to exit code utility

[ErickWendel]

Description

Adds util.convertProcessSignalToExitCode() utility function to convert signal names (e.g., SIGTERM, SIGKILL) to their corresponding POSIX exit codes.

When a child process is terminated by a signal, the code parameter in the 'exit' and 'close' events is null. This utility allows users to convert the signal parameter to the POSIX standard exit code.

Example

import { spawn } from 'node:child_process';
import { once } from 'node:events';
import { convertProcessSignalToExitCode } from 'node:util';

const ls = spawn('ls', ['-lh', '/usr']);

ls.kill();

const [code, signal] = await once(ls, 'exit');
const exitCode = convertProcessSignalToExitCode(signal);
console.log(`signal ${signal}, POSIX exit code: ${exitCode}`);

// signal SIGTERM, POSIX exit code: 143

Note: While Windows doesn't natively support POSIX signals, Node.js provides a cross-platform abstraction that emulates signal behavior. This allows convertProcessSignalToExitCode() to work consistently across all platforms, returning the same POSIX exit codes on both Unix-like systems and Windows.

Refs

• child_process.exitCode is null after process exited #60285
• child_process: set exitCode when process is killed by signal #60720

[addaleax]

I would remove the code samples and move the text to the bottom of the section – there's very little reason why somebody would want to do this, while information such as that stdio streams may still be open is much more directly relevant to what this event does

[ErickWendel]

done

[addaleax]

I think the really important thing we should mention is that subprocess.signalCode will be set, and we should link to that.

[ErickWendel]

done

[addaleax]

Might also be worth linking back to .exitCode from here

[ErickWendel]

done

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 88.54%. Comparing base (cbe0233) to head (ccf99c9).
⚠️ Report is 13 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #60963      +/-   ##
==========================================
+ Coverage   88.53%   88.54%   +0.01%     
==========================================
  Files         703      703              
  Lines      208413   208448      +35     
  Branches    40191    40195       +4     
==========================================
+ Hits       184521   184575      +54     
+ Misses      15902    15884      -18     
+ Partials     7990     7989       -1     

Files with missing lines	Coverage Δ
lib/internal/util.js	96.81% <100.00%> (+0.43%)	⬆️
lib/util.js	97.97% <100.00%> (+<0.01%)	⬆️

... and 43 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.