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: #62797
Signed-off-by: Jonathan Lopes <[email protected]>

Author: JonathanLopes404

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

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;
 

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);
+}

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);

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',
+    });
+  });
+});

test/parallel/test-setproctitle.js

@@ -15,16 +15,26 @@ 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
 // maximum title length is possibly quite short.
 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) {

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',