From e8583be4e40b1e8b3332b85da89846757657c499 Mon Sep 17 00:00:00 2001
From: theanarkh <theratliter@gmail.com>
Date: Sat, 12 Jul 2025 16:39:12 +0800
Subject: [PATCH] lib: add trace-sigint APIs

---
 doc/api/process.md                       |  8 ++++++
 lib/internal/process/pre_execution.js    | 21 ++++++++++++---
 lib/internal/watchdog.js                 |  1 -
 test/parallel/test-start-trace-sigint.js | 32 +++++++++++++++++++++++
 test/parallel/test-stop-trace-sigint.js  | 33 ++++++++++++++++++++++++
 5 files changed, 90 insertions(+), 5 deletions(-)
 create mode 100644 test/parallel/test-start-trace-sigint.js
 create mode 100644 test/parallel/test-stop-trace-sigint.js

diff --git a/doc/api/process.md b/doc/api/process.md
index 9182d25219c92f..ab3e58679bf5e5 100644
--- a/doc/api/process.md
+++ b/doc/api/process.md
@@ -4059,6 +4059,10 @@ This property refers to the value of underlying file descriptor of
 `process.stderr`. The value is fixed at `2`. In [`Worker`][] threads,
 this field does not exist.
 
+## `process.startTraceSigInt`
+
+Prints a stack trace on `SIGINT`.
+
 ## `process.stdin`
 
 * {Stream}
@@ -4168,6 +4172,10 @@ false
 
 See the [TTY][] documentation for more information.
 
+## `process.stopTraceSigInt`
+
+Stop Printing a stack trace on `SIGINT`.
+
 ## `process.throwDeprecation`
 
 <!-- YAML
diff --git a/lib/internal/process/pre_execution.js b/lib/internal/process/pre_execution.js
index c8465facbfaf30..c6a883f0e33b3a 100644
--- a/lib/internal/process/pre_execution.js
+++ b/lib/internal/process/pre_execution.js
@@ -382,14 +382,27 @@ function setupCodeCoverage() {
   }
 }
 
+
+let sigintWatchdog;
+function getSigintWatchdog() {
+  if (!sigintWatchdog) {
+    const { SigintWatchdog } = require('internal/watchdog');
+    sigintWatchdog = new SigintWatchdog();
+  }
+  return sigintWatchdog;
+}
+
 function setupStacktracePrinterOnSigint() {
+  process.startTraceSigInt = function() {
+    getSigintWatchdog().start();
+  };
+  process.stopTraceSigInt = function() {
+    getSigintWatchdog().stop();
+  };
   if (!getOptionValue('--trace-sigint')) {
     return;
   }
-  const { SigintWatchdog } = require('internal/watchdog');
-
-  const watchdog = new SigintWatchdog();
-  watchdog.start();
+  process.startTraceSigInt();
 }
 
 function initializeReport() {
diff --git a/lib/internal/watchdog.js b/lib/internal/watchdog.js
index 543ea6f6b02461..8cac9a2b6ef1c0 100644
--- a/lib/internal/watchdog.js
+++ b/lib/internal/watchdog.js
@@ -53,7 +53,6 @@ class SigintWatchdog extends TraceSigintWatchdog {
   }
 }
 
-
 module.exports = {
   SigintWatchdog,
 };
diff --git a/test/parallel/test-start-trace-sigint.js b/test/parallel/test-start-trace-sigint.js
new file mode 100644
index 00000000000000..44adbfa096277d
--- /dev/null
+++ b/test/parallel/test-start-trace-sigint.js
@@ -0,0 +1,32 @@
+'use strict';
+
+const { mustCall } = require('../common');
+const childProcess = require('child_process');
+const assert = require('assert');
+
+if (!process.env.CHILD) {
+  const cp = childProcess.spawn(
+    process.execPath,
+    [__filename],
+    {
+      env: { ...process.env, CHILD: '1' },
+    });
+  let data;
+  cp.stderr.on('data', (chunk) => {
+    data = data ? data + chunk : chunk;
+  });
+  cp.stderr.on('end', () => {
+    console.log(data);
+    assert.strictEqual(/SIGINT/.test(data.toString()), true);
+  });
+  cp.on('exit', mustCall((code, signal) => {
+    assert.strictEqual(signal, 'SIGINT');
+    assert.strictEqual(code, null);
+  }));
+} else {
+  process.startTraceSigInt();
+  // Deactivate colors even if the tty does support colors.
+  process.env.NODE_DISABLE_COLORS = '1';
+  process.kill(process.pid, 'SIGINT');
+  while (true);
+}
diff --git a/test/parallel/test-stop-trace-sigint.js b/test/parallel/test-stop-trace-sigint.js
new file mode 100644
index 00000000000000..5a74035fa2c1c9
--- /dev/null
+++ b/test/parallel/test-stop-trace-sigint.js
@@ -0,0 +1,33 @@
+'use strict';
+
+const { mustCall } = require('../common');
+const childProcess = require('child_process');
+const assert = require('assert');
+
+if (!process.env.CHILD) {
+  {
+    const cp = childProcess.spawn(
+      process.execPath,
+      ['--trace-sigint', __filename],
+      {
+        env: { ...process.env, CHILD: '1' },
+      });
+    let data;
+    cp.stderr.on('data', (chunk) => {
+      data = data ? data + chunk : chunk;
+    });
+    cp.stderr.on('end', () => {
+      assert.strictEqual(data === undefined, true);
+    });
+    cp.on('exit', mustCall((code, signal) => {
+      assert.strictEqual(signal, 'SIGINT');
+      assert.strictEqual(code, null);
+    }));
+  }
+} else {
+  process.stopTraceSigInt();
+  // Deactivate colors even if the tty does support colors.
+  process.env.NODE_DISABLE_COLORS = '1';
+  process.kill(process.pid, 'SIGINT');
+  while (true);
+}