module: add module.customConditions

Add module.customConditions which exposes the
custom resolution conditions specified by the
user.

Fixes: #55824

Author: sapphi-red

doc/api/module.md

@@ -66,6 +66,42 @@ const require = createRequire(import.meta.url);
 const siblingModule = require('./sibling-module');
 ```
 
+### `module.customConditions`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+* Type: {Set<string>}
+
+The custom resolution conditions specified by the user. The default Node.js conditions are not included.
+
+For example, assuming the following script for `module-customconditions.js`:
+
+```mjs
+import module from 'node:module';
+
+console.log('conditions:', module.customConditions);
+```
+
+```cjs
+const module = require('node:module');
+
+console.log('conditions:', module.customConditions);
+```
+
+Launching the Node.js process as:
+
+```console
+$ node -C additional module-customconditions.js
+```
+
+Would generate the output:
+
+```text
+conditions: Set(1) { 'additional' }
+```
+
 ### `module.findPackageJSON(specifier[, base])`
 
 <!-- YAML

lib/internal/modules/helpers.js

@@ -63,6 +63,18 @@ function toRealPath(requestPath) {
   });
 }
 
+/** @type {Set<string>} */
+let userConditions;
+
+function getUserConditions() {
+  if (userConditions === undefined) {
+    userConditions = new SafeSet([
+      ...getOptionValue('--conditions'),
+    ]);
+  }
+  return userConditions;
+}
+
 /** @type {Set<string>} */
 let cjsConditions;
 /**
@@ -407,6 +419,7 @@ module.exports = {
   enableCompileCache,
   flushCompileCache,
   getBuiltinModule,
+  getUserConditions,
   getCjsConditions,
   getCompileCacheDir,
   initializeCjsConditions,

lib/module.js

@@ -15,6 +15,7 @@ const {
   enableCompileCache,
   flushCompileCache,
   getCompileCacheDir,
+  getUserConditions,
 } = require('internal/modules/helpers');
 const {
   findPackageJSON,
@@ -23,6 +24,12 @@ const { stripTypeScriptTypes } = require('internal/modules/typescript');
 
 Module.register = register;
 Module.constants = constants;
+Object.defineProperty(Module, 'customConditions', {
+  get() {
+    return getUserConditions();
+  },
+  enumerable: true,
+});
 Module.enableCompileCache = enableCompileCache;
 Module.findPackageJSON = findPackageJSON;
 Module.flushCompileCache = flushCompileCache;

test/parallel/test-module-customConditions.js

@@ -0,0 +1,10 @@
+'use strict';
+
+// Flags: -C additional --expose-internals
+
+require('../common');
+const { SafeSet } = require('internal/test/binding').primordials;
+const assert = require('node:assert');
+const { customConditions } = require('module');
+
+assert.deepStrictEqual(customConditions, new SafeSet(['additional']));