vm: expose hasTopLevelAwait on SourceTextModule

Expose `hasTopLevelAwait` and `getHasAsyncGraph` on
`vm.SourceTextModule`.

`getHasAsyncGraph` requires the module to be instantiated first.

Author: legendecas

doc/api/vm.md

@@ -920,6 +920,33 @@ to disallow any changes to it.
 Corresponds to the `[[RequestedModules]]` field of [Cyclic Module Record][]s in
 the ECMAScript specification.
 
+### `sourceTextModule.getHasAsyncGraph()`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+* Returns: {boolean}
+
+Returns `true` if the module has a dependency graph that contains top-level
+`await` expressions, otherwise returns `false`.
+
+This requires the module to be instantiated first. If the module is not
+instantiated yet, an error will be thrown.
+
+### `sourceTextModule.hasTopLevelAwait`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+* Type: {boolean}
+
+Indicates whether the module contains any top-level `await` expressions.
+
+This corresponds to the field `[[HasTLA]]` in [Cyclic Module Record][] in the
+ECMAScript specification.
+
 ### `sourceTextModule.instantiate()`
 
 <!-- YAML

lib/internal/vm/module.js

@@ -429,6 +429,19 @@ class SourceTextModule extends Module {
     return super.error;
   }
 
+  get hasTopLevelAwait() {
+    validateThisInternalField(this, kWrap, 'SourceTextModule');
+    return this[kWrap].hasTopLevelAwait;
+  }
+
+  getHasAsyncGraph() {
+    validateThisInternalField(this, kWrap, 'SourceTextModule');
+    if (this[kWrap].getStatus() < kInstantiated) {
+      throw new ERR_VM_MODULE_STATUS('must be instantiated');
+    }
+    return this[kWrap].hasAsyncGraph;
+  }
+
   createCachedData() {
     const { status } = this;
     if (status === 'evaluating' ||

test/parallel/test-vm-module-gethasasyncgraph.js

@@ -0,0 +1,67 @@
+'use strict';
+
+// Flags: --experimental-vm-modules
+
+require('../common');
+
+const assert = require('assert');
+
+const { SourceTextModule } = require('vm');
+const test = require('node:test');
+
+test('module is not instantiated yet', () => {
+  const foo = new SourceTextModule(`
+    export const foo = 4
+    export default 5;
+  `);
+  assert.throws(() => foo.getHasAsyncGraph(), {
+    code: 'ERR_VM_MODULE_STATUS',
+  });
+});
+
+test('simple module with top-level await', () => {
+  const foo = new SourceTextModule(`
+    export const foo = 4
+    export default 5;
+
+    await 0;
+  `);
+  foo.linkRequests([]);
+  foo.instantiate();
+
+  assert.strictEqual(foo.getHasAsyncGraph(), true);
+});
+
+test('simple module with non top-level await', () => {
+  const foo = new SourceTextModule(`
+    export const foo = 4
+    export default 5;
+
+    export async function f() {
+      await 0;
+    }
+  `);
+  foo.linkRequests([]);
+  foo.instantiate();
+
+  assert.strictEqual(foo.getHasAsyncGraph(), false);
+});
+
+test('module with a dependency containing top-level await', () => {
+  const foo = new SourceTextModule(`
+    export const foo = 4
+    export default 5;
+
+    await 0;
+  `);
+  foo.linkRequests([]);
+
+  const bar = new SourceTextModule(`
+    export { foo } from 'foo';
+  `);
+  bar.linkRequests([foo]);
+  bar.instantiate();
+
+  assert.strictEqual(foo.getHasAsyncGraph(), true);
+  assert.strictEqual(bar.getHasAsyncGraph(), true);
+});

test/parallel/test-vm-module-hastoplevelawait.js

@@ -0,0 +1,59 @@
+'use strict';
+
+// Flags: --experimental-vm-modules
+
+require('../common');
+
+const assert = require('assert');
+
+const { SourceTextModule } = require('vm');
+const test = require('node:test');
+
+test('simple module', () => {
+  const foo = new SourceTextModule(`
+    export const foo = 4
+    export default 5;
+  `);
+  assert.strictEqual(foo.hasTopLevelAwait, false);
+});
+
+test('simple module with top-level await', () => {
+  const foo = new SourceTextModule(`
+    export const foo = 4
+    export default 5;
+
+    await 0;
+  `);
+  assert.strictEqual(foo.hasTopLevelAwait, true);
+});
+
+test('simple module with non top-level await', () => {
+  const foo = new SourceTextModule(`
+    export const foo = 4
+    export default 5;
+
+    export async function f() {
+      await 0;
+    }
+  `);
+  assert.strictEqual(foo.hasTopLevelAwait, false);
+});
+
+test('module with a dependency containing top-level await', () => {
+  const foo = new SourceTextModule(`
+    export const foo = 4
+    export default 5;
+
+    await 0;
+  `);
+  foo.linkRequests([]);
+
+  const bar = new SourceTextModule(`
+    export { foo } from 'foo';
+  `);
+  bar.linkRequests([foo]);
+  bar.instantiate();
+
+  assert.strictEqual(foo.hasTopLevelAwait, true);
+  assert.strictEqual(bar.hasTopLevelAwait, false);
+});