From 5c3ade4d4966755d81be422efd22c148f6677a43 Mon Sep 17 00:00:00 2001
From: Jonathan <jonathan15989@protonmail.com>
Date: Sat, 18 Apr 2026 10:35:21 -0300
Subject: [PATCH 1/2] src: add setTitle() as alternative to direct assignment

Implement process.setTitle(title) as a new function-based API for
setting the process title, complementing the existing process.title
property assignment pattern

Fixes: https://github.com/nodejs/node/issues/62797
Signed-off-by: Jonathan Lopes <jonathan15989@protonmail.com>
---
 doc/api/process.md                            | 27 +++++++++++++++++++
 .../switches/does_not_own_process_state.js    |  1 +
 .../switches/does_own_process_state.js        |  6 +++++
 src/node_process_methods.cc                   | 12 +++++++++
 test/es-module/test-esm-process-set-title.mjs | 27 +++++++++++++++++++
 test/parallel/test-setproctitle.js            | 12 ++++++++-
 .../test-worker-unsupported-things.js         |  2 +-
 7 files changed, 85 insertions(+), 2 deletions(-)
 create mode 100644 test/es-module/test-esm-process-set-title.mjs

diff --git a/doc/api/process.md b/doc/api/process.md
index 61ea3c673e5f19..25f9e708f2ad7c 100644
--- a/doc/api/process.md
+++ b/doc/api/process.md
@@ -4308,6 +4308,32 @@ Assigning a value to `process.title` might not result in an accurate label
 within process manager applications such as macOS Activity Monitor or Windows
 Services Manager.
 
+## `process.setTitle(title)`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+* `title` {string}
+
+Sets the process title. This is equivalent to assigning a string to
+[`process.title`][]. See [`process.title`][] for restrictions and platform
+limitations.
+
+```mjs
+import { setTitle } from 'node:process';
+
+setTitle('my-service');
+```
+
+```cjs
+const { setTitle } = require('node:process');
+
+setTitle('my-service');
+```
+
+This function is not supported in [`Worker`][] threads.
+
 ## `process.traceDeprecation`
 
 <!-- YAML
@@ -4627,6 +4653,7 @@ cases:
 [`process.hrtime.bigint()`]: #processhrtimebigint
 [`process.kill()`]: #processkillpid-signal
 [`process.setUncaughtExceptionCaptureCallback()`]: #processsetuncaughtexceptioncapturecallbackfn
+[`process.title`]: #processtitle
 [`promise.catch()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/catch
 [`queueMicrotask()`]: globals.md#queuemicrotaskcallback
 [`readable.read()`]: stream.md#readablereadsize
diff --git a/lib/internal/bootstrap/switches/does_not_own_process_state.js b/lib/internal/bootstrap/switches/does_not_own_process_state.js
index 8350a7c79d8ba2..4685348fb36f65 100644
--- a/lib/internal/bootstrap/switches/does_not_own_process_state.js
+++ b/lib/internal/bootstrap/switches/does_not_own_process_state.js
@@ -7,6 +7,7 @@ const { unavailable } = require('internal/process/worker_thread_only');
 
 process.abort = unavailable('process.abort()');
 process.chdir = unavailable('process.chdir()');
+process.setTitle = unavailable('process.setTitle()');
 process.umask = wrappedUmask;
 process.cwd = rawMethods.cwd;
 
diff --git a/lib/internal/bootstrap/switches/does_own_process_state.js b/lib/internal/bootstrap/switches/does_own_process_state.js
index 370da66a825f65..88d6472251e416 100644
--- a/lib/internal/bootstrap/switches/does_own_process_state.js
+++ b/lib/internal/bootstrap/switches/does_own_process_state.js
@@ -14,6 +14,7 @@ process.abort = rawMethods.abort;
 process.umask = wrappedUmask;
 process.chdir = wrappedChdir;
 process.cwd = wrappedCwd;
+process.setTitle = wrappedSetTitle;
 
 if (credentials.implementsPosixCredentials) {
   const wrapped = wrapPosixCredentialSetters(credentials);
@@ -142,3 +143,8 @@ function wrappedCwd() {
     cachedCwd = rawMethods.cwd();
   return cachedCwd;
 }
+
+function wrappedSetTitle(title) {
+  validateString(title, 'title');
+  rawMethods.setTitle(title);
+}
diff --git a/src/node_process_methods.cc b/src/node_process_methods.cc
index 6488fca90d68a8..cb241ee7f4b07c 100644
--- a/src/node_process_methods.cc
+++ b/src/node_process_methods.cc
@@ -100,6 +100,16 @@ static void Chdir(const FunctionCallbackInfo<Value>& args) {
   }
 }
 
+static void SetTitle(const FunctionCallbackInfo<Value>& args) {
+  Environment* env = Environment::GetCurrent(args);
+  CHECK(env->owns_process_state());
+
+  CHECK_EQ(args.Length(), 1);
+  CHECK(args[0]->IsString());
+  Utf8Value title(env->isolate(), args[0]);
+  uv_set_process_title(*title);
+}
+
 inline Local<ArrayBuffer> get_fields_array_buffer(
     const FunctionCallbackInfo<Value>& args,
     size_t index,
@@ -771,6 +781,7 @@ static void CreatePerIsolateProperties(IsolateData* isolate_data,
   SetMethod(isolate, target, "abort", Abort);
   SetMethod(isolate, target, "causeSegfault", CauseSegfault);
   SetMethod(isolate, target, "chdir", Chdir);
+  SetMethod(isolate, target, "setTitle", SetTitle);
 
   SetMethod(isolate, target, "umask", Umask);
   SetMethod(isolate, target, "memoryUsage", MemoryUsage);
@@ -819,6 +830,7 @@ void RegisterExternalReferences(ExternalReferenceRegistry* registry) {
   registry->Register(Abort);
   registry->Register(CauseSegfault);
   registry->Register(Chdir);
+  registry->Register(SetTitle);
 
   registry->Register(Umask);
   registry->Register(RawDebug);
diff --git a/test/es-module/test-esm-process-set-title.mjs b/test/es-module/test-esm-process-set-title.mjs
new file mode 100644
index 00000000000000..6b25fdb5c416a6
--- /dev/null
+++ b/test/es-module/test-esm-process-set-title.mjs
@@ -0,0 +1,27 @@
+import { isIBMi, isSunOS, isWindows, skip } from '../common/index.mjs';
+import assert from 'node:assert';
+import process, { setTitle } from 'node:process';
+import { isMainThread } from 'node:worker_threads';
+import { describe, it } from 'node:test';
+
+// FIXME add sunos support
+if (isSunOS || isIBMi || isWindows) {
+  skip(`Unsupported platform [${process.platform}]`);
+}
+
+if (!isMainThread) {
+  skip('Setting the process title from Workers is not supported');
+}
+
+describe('ESM named import setTitle', () => {
+  it('sets process title through node:process', () => {
+    const title = String(process.pid);
+
+    setTitle(title);
+    assert.strictEqual(process.title, title);
+
+    assert.throws(() => setTitle(1), {
+      code: 'ERR_INVALID_ARG_TYPE',
+    });
+  });
+});
diff --git a/test/parallel/test-setproctitle.js b/test/parallel/test-setproctitle.js
index 368bc85800a9a9..36bcf8d5ffade3 100644
--- a/test/parallel/test-setproctitle.js
+++ b/test/parallel/test-setproctitle.js
@@ -15,6 +15,7 @@ if (!isMainThread) {
 const assert = require('assert');
 const { exec, execSync } = require('child_process');
 const path = require('path');
+const { setTitle } = require('node:process');
 
 // The title shouldn't be too long; libuv's uv_set_process_title() out of
 // security considerations no longer overwrites envp, only argv, so the
@@ -22,9 +23,18 @@ const path = require('path');
 let title = String(process.pid);
 
 assert.notStrictEqual(process.title, title);
-process.title = title;
+setTitle(title);
 assert.strictEqual(process.title, title);
 
+assert.throws(() => setTitle(1), {
+  code: 'ERR_INVALID_ARG_TYPE',
+});
+
+const legacyTitle = `${title}-legacy`;
+process.title = legacyTitle;
+assert.strictEqual(process.title, legacyTitle);
+title = legacyTitle;
+
 try {
   execSync('command -v ps');
 } catch (err) {
diff --git a/test/parallel/test-worker-unsupported-things.js b/test/parallel/test-worker-unsupported-things.js
index 95d93d24dec9f1..2aeac18aea4b76 100644
--- a/test/parallel/test-worker-unsupported-things.js
+++ b/test/parallel/test-worker-unsupported-things.js
@@ -34,7 +34,7 @@ if (!process.env.HAS_STARTED_WORKER) {
     });
   }
 
-  const stubs = ['abort', 'chdir', 'send', 'disconnect'];
+  const stubs = ['abort', 'chdir', 'setTitle', 'send', 'disconnect'];
 
   if (!common.isWindows) {
     stubs.push('setuid', 'seteuid', 'setgid',

From c16ebdd33c801631735936c45ecbfafa764d796d Mon Sep 17 00:00:00 2001
From: Jonathan <jonathan15989@protonmail.com>
Date: Sat, 18 Apr 2026 20:33:02 -0300
Subject: [PATCH 2/2] src: add setTitle() api reusing process.title path

Add process.setTitle(title) as a new API while reusing the existing
process.title assignment behavior instead of introducing a separate
native code path.

Signed-off-by: Jonathan Lopes <jonathan15989@protonmail.com>
---
 doc/api/process.md                                   |  2 --
 .../bootstrap/switches/does_not_own_process_state.js | 10 +++++++++-
 .../bootstrap/switches/does_own_process_state.js     |  2 +-
 src/node_process_methods.cc                          | 12 ------------
 test/parallel/test-worker-unsupported-things.js      |  5 ++++-
 5 files changed, 14 insertions(+), 17 deletions(-)

diff --git a/doc/api/process.md b/doc/api/process.md
index 25f9e708f2ad7c..8de29d9bcc7be2 100644
--- a/doc/api/process.md
+++ b/doc/api/process.md
@@ -4332,8 +4332,6 @@ const { setTitle } = require('node:process');
 setTitle('my-service');
 ```
 
-This function is not supported in [`Worker`][] threads.
-
 ## `process.traceDeprecation`
 
 <!-- YAML
diff --git a/lib/internal/bootstrap/switches/does_not_own_process_state.js b/lib/internal/bootstrap/switches/does_not_own_process_state.js
index 4685348fb36f65..8e1b51aab7194b 100644
--- a/lib/internal/bootstrap/switches/does_not_own_process_state.js
+++ b/lib/internal/bootstrap/switches/does_not_own_process_state.js
@@ -7,7 +7,7 @@ const { unavailable } = require('internal/process/worker_thread_only');
 
 process.abort = unavailable('process.abort()');
 process.chdir = unavailable('process.chdir()');
-process.setTitle = unavailable('process.setTitle()');
+process.setTitle = wrappedSetTitle;
 process.umask = wrappedUmask;
 process.cwd = rawMethods.cwd;
 
@@ -28,6 +28,9 @@ const {
     ERR_WORKER_UNSUPPORTED_OPERATION,
   },
 } = require('internal/errors');
+const {
+  validateString,
+} = require('internal/validators');
 
 function wrappedUmask(mask) {
   // process.umask() is a read-only operation in workers.
@@ -37,3 +40,8 @@ function wrappedUmask(mask) {
 
   return rawMethods.umask(mask);
 }
+
+function wrappedSetTitle(title) {
+  validateString(title, 'title');
+  process.title = title;
+}
diff --git a/lib/internal/bootstrap/switches/does_own_process_state.js b/lib/internal/bootstrap/switches/does_own_process_state.js
index 88d6472251e416..bc678645aabf07 100644
--- a/lib/internal/bootstrap/switches/does_own_process_state.js
+++ b/lib/internal/bootstrap/switches/does_own_process_state.js
@@ -146,5 +146,5 @@ function wrappedCwd() {
 
 function wrappedSetTitle(title) {
   validateString(title, 'title');
-  rawMethods.setTitle(title);
+  process.title = title;
 }
diff --git a/src/node_process_methods.cc b/src/node_process_methods.cc
index cb241ee7f4b07c..6488fca90d68a8 100644
--- a/src/node_process_methods.cc
+++ b/src/node_process_methods.cc
@@ -100,16 +100,6 @@ static void Chdir(const FunctionCallbackInfo<Value>& args) {
   }
 }
 
-static void SetTitle(const FunctionCallbackInfo<Value>& args) {
-  Environment* env = Environment::GetCurrent(args);
-  CHECK(env->owns_process_state());
-
-  CHECK_EQ(args.Length(), 1);
-  CHECK(args[0]->IsString());
-  Utf8Value title(env->isolate(), args[0]);
-  uv_set_process_title(*title);
-}
-
 inline Local<ArrayBuffer> get_fields_array_buffer(
     const FunctionCallbackInfo<Value>& args,
     size_t index,
@@ -781,7 +771,6 @@ static void CreatePerIsolateProperties(IsolateData* isolate_data,
   SetMethod(isolate, target, "abort", Abort);
   SetMethod(isolate, target, "causeSegfault", CauseSegfault);
   SetMethod(isolate, target, "chdir", Chdir);
-  SetMethod(isolate, target, "setTitle", SetTitle);
 
   SetMethod(isolate, target, "umask", Umask);
   SetMethod(isolate, target, "memoryUsage", MemoryUsage);
@@ -830,7 +819,6 @@ void RegisterExternalReferences(ExternalReferenceRegistry* registry) {
   registry->Register(Abort);
   registry->Register(CauseSegfault);
   registry->Register(Chdir);
-  registry->Register(SetTitle);
 
   registry->Register(Umask);
   registry->Register(RawDebug);
diff --git a/test/parallel/test-worker-unsupported-things.js b/test/parallel/test-worker-unsupported-things.js
index 2aeac18aea4b76..c41ee3741be8e9 100644
--- a/test/parallel/test-worker-unsupported-things.js
+++ b/test/parallel/test-worker-unsupported-things.js
@@ -17,6 +17,9 @@ if (!process.env.HAS_STARTED_WORKER) {
     const after = before + ' in worker';
     process.title = after;
     assert.strictEqual(process.title, after);
+
+    process.setTitle(`${after} via function`);
+    assert.strictEqual(process.title, `${after} via function`);
   }
 
   {
@@ -34,7 +37,7 @@ if (!process.env.HAS_STARTED_WORKER) {
     });
   }
 
-  const stubs = ['abort', 'chdir', 'setTitle', 'send', 'disconnect'];
+  const stubs = ['abort', 'chdir', 'send', 'disconnect'];
 
   if (!common.isWindows) {
     stubs.push('setuid', 'seteuid', 'setgid',