esm: add import.meta.require

Author: marco-ippolito

doc/api/esm.md

@@ -384,6 +384,20 @@ 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)(specifier)`][].
+
 ### `import.meta.resolve(specifier)`
 
 <!-- YAML
@@ -1118,6 +1132,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)(specifier)`]: module.md#modulecreaterequirefilename
 [`module.syncBuiltinESMExports()`]: module.md#modulesyncbuiltinesmexports
 [`package.json`]: packages.md#nodejs-packagejson-field-definitions
 [`path.dirname()`]: path.md#pathdirnamepath

lib/internal/modules/esm/initialize_import_meta.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const {
+  ObjectDefineProperty,
   StringPrototypeStartsWith,
 } = primordials;
 
@@ -71,6 +72,18 @@ 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');
+      const req = createRequire(url);
+      ObjectDefineProperty(this, 'require', { __proto__: null, value: req });
+      return this.require;
+    },
+  });
+
   return meta;
 }
 

test/es-module/test-esm-import-meta.mjs

@@ -3,9 +3,20 @@ 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.set, 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.

test/es-module/test-import-meta-require.mjs

@@ -0,0 +1,31 @@
+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 throw MODULE_NOT_FOUND', () => {
+    try {
+      import.meta.require('does-not-exist');
+      assert.fail();
+    } catch (e) {
+      assert.strictEqual(e.code, 'MODULE_NOT_FOUND');
+    }
+  });
+});

test/fixtures/es-modules/cjs-module-exports.js

@@ -0,0 +1,4 @@
+module.exports = {
+    foo: 'foo',
+    bar: 'bar'
+}