From 44652ff16bd82b84fbb7597d7f0f4f30b3d35756 Mon Sep 17 00:00:00 2001
From: Marco Ippolito <marcoippolito54@gmail.com>
Date: Tue, 5 Nov 2024 16:19:40 +0000
Subject: [PATCH] esm: add `import.meta.require`

---
 doc/api/esm.md                                | 14 ++++++++
 .../modules/esm/initialize_import_meta.js     | 16 +++++++++
 test/es-module/test-esm-import-meta.mjs       | 12 ++++++-
 test/es-module/test-import-meta-require.mjs   | 34 +++++++++++++++++++
 .../fixtures/es-modules/cjs-module-exports.js |  4 +++
 test/fixtures/es-modules/foobar.json          |  4 +++
 6 files changed, 83 insertions(+), 1 deletion(-)
 create mode 100644 test/es-module/test-import-meta-require.mjs
 create mode 100644 test/fixtures/es-modules/cjs-module-exports.js
 create mode 100644 test/fixtures/es-modules/foobar.json

diff --git a/doc/api/esm.md b/doc/api/esm.md
index 4d257c37bf01ff..e8622ada5adc12 100644
--- a/doc/api/esm.md
+++ b/doc/api/esm.md
@@ -384,6 +384,19 @@ import { readFileSync } from 'node:fs';
 const buffer = readFileSync(new URL('./data.proto', import.meta.url));
 ```
 
+### `import.meta.require(id)`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+> Stability: 1.1 - Active development
+
+* `id` {string} The module name or path.
+* Returns: {any} The module exports.
+
+Alias for [`module.createRequire(import.meta.url)(id)`][].
+
 ### `import.meta.resolve(specifier)`
 
 <!-- YAML
@@ -1118,6 +1131,7 @@ resolution for ESM specifiers is [commonjs-extension-resolution-loader][].
 [`import.meta.url`]: #importmetaurl
 [`import`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import
 [`module.createRequire()`]: module.md#modulecreaterequirefilename
+[`module.createRequire(import.meta.url)(id)`]: module.md#modulecreaterequirefilename
 [`module.syncBuiltinESMExports()`]: module.md#modulesyncbuiltinesmexports
 [`package.json`]: packages.md#nodejs-packagejson-field-definitions
 [`path.dirname()`]: path.md#pathdirnamepath
diff --git a/lib/internal/modules/esm/initialize_import_meta.js b/lib/internal/modules/esm/initialize_import_meta.js
index 43064f14b057a4..3779b7eb4f6fe2 100644
--- a/lib/internal/modules/esm/initialize_import_meta.js
+++ b/lib/internal/modules/esm/initialize_import_meta.js
@@ -1,12 +1,14 @@
 'use strict';
 
 const {
+  ObjectDefineProperty,
   StringPrototypeStartsWith,
 } = primordials;
 
 const { getOptionValue } = require('internal/options');
 const { fileURLToPath } = require('internal/url');
 const { dirname } = require('path');
+const { setOwnProperty } = require('internal/util');
 const experimentalImportMetaResolve = getOptionValue('--experimental-import-meta-resolve');
 
 /**
@@ -71,6 +73,20 @@ function initializeImportMeta(meta, context, loader) {
 
   meta.url = url;
 
+  ObjectDefineProperty(meta, 'require', {
+    __proto__: null,
+    enumerable: true,
+    configurable: true,
+    get() {
+      const { Module: { createRequire } } = require('internal/modules/cjs/loader');
+      this.require = createRequire(url);
+      return this.require;
+    },
+    set(value) {
+      setOwnProperty(this, 'require', value);
+    },
+  });
+
   return meta;
 }
 
diff --git a/test/es-module/test-esm-import-meta.mjs b/test/es-module/test-esm-import-meta.mjs
index 50d16a3438a851..d7494e723a822d 100644
--- a/test/es-module/test-esm-import-meta.mjs
+++ b/test/es-module/test-esm-import-meta.mjs
@@ -3,9 +3,19 @@ import assert from 'assert';
 
 assert.strictEqual(Object.getPrototypeOf(import.meta), null);
 
-const keys = ['dirname', 'filename', 'resolve', 'url'];
+const keys = ['dirname', 'filename', 'resolve', 'url', 'require'];
 assert.deepStrictEqual(Reflect.ownKeys(import.meta), keys);
 
+{
+  const requireDescriptor = Object.getOwnPropertyDescriptor(import.meta, 'require');
+  assert.strictEqual(requireDescriptor.value, undefined);
+  assert.strictEqual(requireDescriptor.enumerable, true);
+  assert.strictEqual(requireDescriptor.writable, undefined);
+  assert.strictEqual(requireDescriptor.configurable, true);
+}
+
+delete import.meta.require; // Verified above.
+
 const descriptors = Object.getOwnPropertyDescriptors(import.meta);
 for (const descriptor of Object.values(descriptors)) {
   delete descriptor.value; // Values are verified below.
diff --git a/test/es-module/test-import-meta-require.mjs b/test/es-module/test-import-meta-require.mjs
new file mode 100644
index 00000000000000..5044b524ddaf25
--- /dev/null
+++ b/test/es-module/test-import-meta-require.mjs
@@ -0,0 +1,34 @@
+import '../common/index.mjs';
+import assert from 'node:assert';
+import { describe, it } from 'node:test';
+
+describe('import.meta.require', () => {
+  it('should require a built-in module', () => {
+    const requiredAssert = import.meta.require('node:assert');
+    assert.deepStrictEqual(assert, requiredAssert);
+  });
+
+  it('should require a esm module', () => {
+    const { foo, bar } = import.meta.require('../fixtures/es-module-loaders/module-named-exports.mjs');
+    assert.strictEqual(foo, 'foo');
+    assert.strictEqual(bar, 'bar');
+  });
+
+  it('should require a cjs module', () => {
+    const { foo, bar } = import.meta.require('../fixtures/es-modules/cjs-module-exports.js');
+    assert.strictEqual(foo, 'foo');
+    assert.strictEqual(bar, 'bar');
+  });
+
+  it('should require a json module', () => {
+    const { foo, bar } = import.meta.require('../fixtures/es-modules/foobar.json');
+    assert.strictEqual(foo, 'foo');
+    assert.strictEqual(bar, 'bar');
+  });
+
+  it('should throw MODULE_NOT_FOUND', () => {
+    assert.throws(() => import.meta.require('does-not-exist'), {
+      code: 'MODULE_NOT_FOUND'
+    });
+  });
+});
diff --git a/test/fixtures/es-modules/cjs-module-exports.js b/test/fixtures/es-modules/cjs-module-exports.js
new file mode 100644
index 00000000000000..5484e053e4dde5
--- /dev/null
+++ b/test/fixtures/es-modules/cjs-module-exports.js
@@ -0,0 +1,4 @@
+module.exports = {
+    foo: 'foo',
+    bar: 'bar'
+}
diff --git a/test/fixtures/es-modules/foobar.json b/test/fixtures/es-modules/foobar.json
new file mode 100644
index 00000000000000..f88481821185db
--- /dev/null
+++ b/test/fixtures/es-modules/foobar.json
@@ -0,0 +1,4 @@
+{
+    "foo": "foo",
+    "bar": "bar"
+}