SyntheticModule

external class SyntheticModule : Module(source)

This feature is only available with the --experimental-vm-modules command flag enabled.

The vm.SyntheticModule class provides the Synthetic Module Record as defined in the WebIDL specification. The purpose of synthetic modules is to provide a generic interface for exposing non-JavaScript sources to ECMAScript module graphs.

import vm from 'node:vm';

const source = '{ "a": 1 }';
const module = new vm.SyntheticModule(['default'], function() {
  const obj = JSON.parse(source);
  this.setExport('default', obj);
});

// Use `module` in linking...

Since

v13.0.0, v12.16.0

Constructors

SyntheticModule

constructor(exportNames: <Error class: unknown class><String>, evaluateCallback: () -> Unit, options: SyntheticModuleOptions = definedExternally)

Creates a new SyntheticModule instance.

Properties

context

var context: Context

dependencySpecifiers

var dependencySpecifiers: <Error class: unknown class><String>

The specifiers of all dependencies of this module. The returned array is frozen to disallow any changes to it.

error

var error: Any?

If the module.status is 'errored', this property contains the exception thrown by the module during evaluation. If the status is anything else, accessing this property will result in a thrown exception.

identifier

var identifier: String

The identifier of the current module, as set in the constructor.

namespace

var namespace: Any

The namespace object of the module. This is only available after linking (module.link()) has completed.

status

var status: ModuleStatus

The current status of the module. Will be one of:

Functions

evaluate

fun evaluate(options: ModuleEvaluateOptions = definedExternally): <Error class: unknown class><<Error class: unknown class>>

Evaluate the module.

link

fun link(linker: ModuleLinker): <Error class: unknown class><<Error class: unknown class>>

Link module dependencies. This method must be called before evaluation, and can only be called once per module.

setExport

fun setExport(name: String, value: Any?)

This method is used after the module is linked to set the values of exports. If it is called before the module is linked, an ERR_VM_MODULE_STATUS error will be thrown.