method

vm.Script.runInThisContext

options?: RunningScriptOptions
): any;

Runs the compiled code contained by the vm.Script within the context of the current global object. Running code does not have access to local scope, but does have access to the current global object.

The following example compiles code that increments a global variable then executes that code multiple times:

import { Script } from 'node:vm';

global.globalVar = 0;

const script = new Script('globalVar += 1', { filename: 'myfile.vm' });

for (let i = 0; i < 1000; ++i) {
  script.runInThisContext();
}

console.log(globalVar);

// 1000
@returns

the result of the very last statement executed in the script.

Referenced types

interface RunningScriptOptions

  • breakOnSigint?: boolean

    If true, the execution will be terminated when SIGINT (Ctrl+C) is received. Existing handlers for the event that have been attached via process.on('SIGINT') will be disabled during script execution, but will continue to work after that. If execution is terminated, an Error will be thrown.

  • columnOffset?: number

    Specifies the column number offset that is displayed in stack traces produced by this script.

  • displayErrors?: boolean

    When true, if an Error occurs while compiling the code, the line of code causing the error is attached to the stack trace.

  • filename?: string

    Specifies the filename used in stack traces produced by this script.

  • lineOffset?: number

    Specifies the line number offset that is displayed in stack traces produced by this script.

  • timeout?: number

    Specifies the number of milliseconds to execute code before terminating execution. If execution is terminated, an Error will be thrown. This value must be a strictly positive integer.