From afe4f5617962ec0ddcd95cd1f3485cf864d08281 Mon Sep 17 00:00:00 2001
From: Xavier Stouder <xavier@stouder.io>
Date: Fri, 9 Jan 2026 22:27:04 +0100
Subject: [PATCH] lib: add `process.loadedModules` list

Add a new `process.loadedModules` property that returns an array
of public core module names that have been loaded during the current
Node.js process execution. This provides a cleaner, documented API
for accessing loaded module information compared to the undocumented
`process.moduleLoadList`.

Fixes: https://github.com/nodejs/node/issues/41233
Refs: https://github.com/nodejs/node/pull/61276
---
 doc/api/process.md                          | 24 +++++++++++++++++++++
 lib/internal/bootstrap/realm.js             | 12 +++++++++++
 test/parallel/test-process-loadedmodules.js |  7 ++++++
 3 files changed, 43 insertions(+)
 create mode 100644 test/parallel/test-process-loadedmodules.js

diff --git a/doc/api/process.md b/doc/api/process.md
index 04ca0eff9c55d4..9cb77bf515d4fd 100644
--- a/doc/api/process.md
+++ b/doc/api/process.md
@@ -2696,6 +2696,30 @@ process.kill(process.pid, 'SIGHUP');
 When `SIGUSR1` is received by a Node.js process, Node.js will start the
 debugger. See [Signal Events][].
 
+## `process.loadedModules`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+* Type: {string\[]}
+  The `process.loadedModules` property returns an array of core modules that
+  were loaded during the current Node.js process execution.
+
+```mjs
+import process from 'node:process';
+
+console.log(process.loadedModules);
+// ['events', 'buffer', 'diagnostics_channel', 'async_hooks', ...]
+```
+
+```cjs
+const process = require('node:process');
+
+console.log(process.loadedModules);
+// ['events', 'buffer', 'diagnostics_channel', 'async_hooks', ...]
+```
+
 ## `process.loadEnvFile(path)`
 
 <!-- YAML
diff --git a/lib/internal/bootstrap/realm.js b/lib/internal/bootstrap/realm.js
index f49f0814bbc687..13b17ace781922 100644
--- a/lib/internal/bootstrap/realm.js
+++ b/lib/internal/bootstrap/realm.js
@@ -80,6 +80,15 @@ ObjectDefineProperty(process, 'moduleLoadList', {
   writable: false,
 });
 
+// Set up process.loadedModules
+const loadedModules = [];
+ObjectDefineProperty(process, 'loadedModules', {
+  __proto__: null,
+  get() { return ArrayPrototypeSlice(loadedModules); },
+  configurable: true,
+  enumerable: true,
+});
+
 
 // processBindingAllowList contains the name of bindings that are allowed
 // for access via process.binding(). This is used to provide a transition
@@ -405,6 +414,9 @@ class BuiltinModule {
     // "NativeModule" is a legacy name of "BuiltinModule". We keep it
     // here to avoid breaking users who parse process.moduleLoadList.
     ArrayPrototypePush(moduleLoadList, `NativeModule ${id}`);
+    if (!StringPrototypeStartsWith(id, 'internal/')) {
+      ArrayPrototypePush(loadedModules, id);
+    }
     return this.exports;
   }
 }
diff --git a/test/parallel/test-process-loadedmodules.js b/test/parallel/test-process-loadedmodules.js
new file mode 100644
index 00000000000000..67ba4e9fee5c39
--- /dev/null
+++ b/test/parallel/test-process-loadedmodules.js
@@ -0,0 +1,7 @@
+'use strict';
+
+require('../common');
+const assert = require('assert');
+
+assert.ok(Array.isArray(process.loadedModules));
+assert.throws(() => process.loadedModules = 'foo', /^TypeError: Cannot set property loadedModules of #<process> which has only a getter$/);