vm.runInContext(code, contextifiedObject[, options])
code<string> 用于编译和运行的 JavaScript 代码。contextifiedObject<Object> 在编译和运行code时将作为global使用的 情境化 对象。options<Object> | <string>filename<string> 指定此脚本生成的堆栈跟踪中使用的文件名。默认值:'evalmachine.<anonymous>'。lineOffset<number> 指定此脚本生成的堆栈跟踪中显示的行号偏移。默认值:0。columnOffset<number> 指定此脚本生成的堆栈跟踪中显示的首行列偏移量。默认值:0。displayErrors<boolean> 当设置为true时,如果在编译code时发生Error,导致错误的代码行会附加到堆栈跟踪中。默认值:true。timeout<integer> 指定执行code前的毫秒数,超过此时间将终止执行。如果执行被终止,将抛出一个Error。此值必须是严格正整数。breakOnSigint<boolean> 如果为true,接收到SIGINT(Ctrl+C)将终止执行并抛出一个Error。在脚本执行期间,通过process.on('SIGINT')附加的现有事件处理程序将被禁用,但在脚本执行后仍然继续工作。默认值:false。cachedData<Buffer> | <TypedArray> | <DataView> 提供了一个可选的Buffer、TypedArray或DataView,其中包含所提供源代码的 V8 代码缓存数据。importModuleDynamically<Function> 在评估此模块时被调用,当调用import()时使用。如果未指定此选项,调用import()将会因ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING而被拒绝。此选项是实验性模块 API 的一部分。我们不建议在生产环境中使用它。specifier<string> 传递给import()的指定符script<vm.Script>- 'importAssertions' <Object> 'assert' 值传递给
optionsExpression可选参数,若未提供值则为空对象。 - 返回值:<Module Namespace Object> | <vm.Module> 推荐返回
vm.Module,以便利用错误跟踪,并避免包含then函数导出的命名空间出现问题。
- 返回:<any> 脚本中最后执行的语句的结果。
vm.runInContext() 方法会编译 code,在 contextifiedObject 的上下文中运行它,然后返回结果。运行的代码无法访问本地作用域。contextifiedObject 对象必须之前使用 vm.createContext() 方法被 情境化。
🌐 The vm.runInContext() method compiles code, runs it within the context of
the contextifiedObject, then returns the result. Running code does not have
access to the local scope. The contextifiedObject object must have been
previously contextified using the vm.createContext() method.
如果 options 是字符串,那么它指定文件名。
🌐 If options is a string, then it specifies the filename.
以下示例使用单个 情境化 对象编译并执行不同的脚本:
🌐 The following example compiles and executes different scripts using a single contextified object:
const vm = require('node:vm');
const contextObject = { globalVar: 1 };
vm.createContext(contextObject);
for (let i = 0; i < 10; ++i) {
vm.runInContext('globalVar *= 2;', contextObject);
}
console.log(contextObject);
// Prints: { globalVar: 1024 }