-

虚拟机

  1. 稳定性: 3 - 稳定

本节介绍了Node.js的虚拟机(VM)模块,该模块提供了用于在V8虚拟机上下文中编译和运行代码的API。

可以通过以下方法访问该模块:

  1. var vm = require('vm');

JavaScript 可以立即编译立即执行,也可以编译,保存,之后再运行。

vm.runInThisContext(code[, options])

  1. vm.runInThisContext()
对参数
  1. code
编译,运行并返回结果。运行的代码没有权限访问本地作用域(local scope),但是可以访问全局对象。

使用

  1. vm.runInThisContext
  1. eval
方法运行同样代码的例子:

  1. var localVar = 'initial value';
  2. var vmResult = vm.runInThisContext('localVar = "vm";');
  3. console.log('vmResult: ', vmResult);
  4. console.log('localVar: ', localVar);
  5. var evalResult = eval('localVar = "eval";');
  6. console.log('evalResult: ', evalResult);
  7. console.log('localVar: ', localVar);
  8. // vmResult: 'vm', localVar: 'initial value'
  9. // evalResult: 'eval', localVar: 'eval'

  1. vm.runInThisContext
没有访问本地作用域,所以没有改变
  1. localVar
  1. eval
范围了本地作用域,所以改变了
  1. localVar

  1. vm.runInThisContext
用起来很像间接调用
  1. eval
,比如
  1. (0,eval)('code')
。但是,
  1. vm.runInThisContext
也包含以下选项:

    1. filename
    : 允许更改显示在站追踪(stack traces)的文件名。
    1. displayErrors
    : 是否在stderr上打印错误,抛出异常的代码行高亮显示。会捕获编译时的语法错误,和执行时抛出的错误。默认为
    1. true
    1. timeout
    : 中断前代码执行的毫秒数。如果执行终止,将会抛出错误。

vm.createContext([sandbox])

如果参数

  1. sandbox
不为空,调用
  1. vm.runInContext
  1. script.runInContext
时可以调用沙箱的上下文。以此方式运行的脚本,
  1. sandbox
是全局对象,它保留自己的属性同时拥有标准全局对象(global object)拥有的内置对象和函数。

如果参数sandbox对象为空,返回一个可用的新且空的上下文相关的沙盒对象。

这个函数对于创建一个可运行多脚本的沙盒非常有用。比如,在模拟浏览器的时候可以使用该函数创建一个用于表示window全局对象的沙箱,并将所有

  1. <script>
标签放入沙箱执行。

vm.isContext(sandbox)

沙箱对象是否已经通过调用

  1. vm.createContext
上下文化。

vm.runInContext(code, contextifiedSandbox[, options])

  1. vm.runInContext
编译代码,运行在
  1. contextifiedSandbox
并返回结果。运行代码不能访问本地域。
  1. contextifiedSandbox
对象必须通过
  1. vm.createContext
上下文化;
  1. code
会通过全局变量使用它。

  1. vm.runInContext
  1. vm.runInThisContext
参数相同。

在同一个上下文中编译并执行不同的脚本,例子:

  1. var util = require('util');
  2. var vm = require('vm');
  3. var sandbox = { globalVar: 1 };
  4. vm.createContext(sandbox);
  5. for (var i = 0; i < 10; ++i) {
  6. vm.runInContext('globalVar *= 2;', sandbox);
  7. }
  8. console.log(util.inspect(sandbox));
  9. // { globalVar: 1024 }

注意,执行不被信任的代码是需要技巧且要非常的小心。

  1. vm.runInContext
非常有用,不过想要安全些,最好还是在独立的进程里运行不被信任的代码。

vm.runInNewContext(code[, sandbox][, options])

  1. vm.runInNewContext
编译代码, 如果提供了sandbox ,则将sandbox上下文化,否则创建一个新的上下文化过的沙盒,将沙盒作为全局变量运行代码并返回结果。

  1. vm.runInNewContext
  1. vm.runInThisContext
参数相同。

编译并执行代码,增加全局变量值,并设置一个新的。这些全局变量包含在一个新的沙盒里。

  1. var util = require('util');
  2. var vm = require('vm'),
  3. var sandbox = {
  4. animal: 'cat',
  5. count: 2
  6. };
  7. vm.runInNewContext('count += 1; name = "kitty"', sandbox);
  8. console.log(util.inspect(sandbox));
  9. // { animal: 'cat', count: 3, name: 'kitty' }

注意,执行不被信任的代码是需要技巧且要非常的小心。

  1. vm.runInNewContext
非常有用,不过想要安全些,最好还是在独立的进程里运行不被信任的代码。

vm.runInDebugContext(code)

  1. vm.runInDebugContext
在V8的调试上下文中编译并执行。最主要的应用场景是获得V8调试对象访问权限。

  1. var Debug = vm.runInDebugContext('Debug');
  2. Debug.scripts().forEach(function(script) { console.log(script.name); });

注意,调试上下文和对象内部绑定到V8的调试实现里,并可能在没有警告时改变(或移除)。

可以通过

  1. --expose_debug_as=
开关暴露调试对象。

Class: Script

包含预编译脚本的类,并在指定的沙盒里执行。

new vm.Script(code, options)

创建一个新的脚本编译代码,但是不运行。使用被创建的

  1. vm.Script
来表示编译完的代码。这个代码可以使用以下的方法调用多次。返回的脚本没有绑定到任何全局变量。在运行前绑定,执行后释放。

创建脚本的选项有:

    1. filename
    : 允许更改显示在站追踪(stack traces)的文件名。
    1. displayErrors
    : 是否在stderr上打印错误,抛出异常的代码行高亮显示。只会捕获编译时的语法错误,执行时抛出的错误由脚本的方法的选项来控制。默认为
    1. true

script.runInThisContext([options])

  1. vm.runInThisContext
类似,只是作为
  1. Script
脚本对象的预编译方法。
  1. script.runInThisContext
执行编译过的脚本并返回结果。被运行的代码没有本地作用域访问权限,但是拥有权限访问全局对象。

以下例子,使用

  1. script.runInThisContext
编译代码一次,并运行多次:

  1. var vm = require('vm');
  2. global.globalVar = 0;
  3. var script = new vm.Script('globalVar += 1', { filename: 'myfile.vm' });
  4. for (var i = 0; i < 1000; ++i) {
  5. script.runInThisContext();
  6. }
  7. console.log(globalVar);
  8. // 1000

所运行的代码选项:

    1. displayErrors
    : 是否在stderr上打印错误,抛出异常的代码行高亮显示。仅适用于执行时抛出的错误。不能创建一个语法错误的
    1. Script
    实例,因为构造函数会抛出。
    1. timeout
    : 中断前代码执行的毫秒数。如果执行终止,将会抛出错误。

script.runInContext(contextifiedSandbox[, options])

  1. vm.runInContext
类似,只是作为预编译的
  1. Script
对象方法。
  1. script.runInContext
运行脚本(在
  1. contextifiedSandbox
中编译)并返回结果。运行的代码没有权限访问本地域。

  1. script.runInContext
的选项和
  1. script.runInThisContext
类似。

例子:编译一段代码,并执行多次,这段代码实现了一个全局变量的自增,并创建一个新的全局变量。这些全局变量保存在沙盒里。

  1. var util = require('util');
  2. var vm = require('vm');
  3. var sandbox = {
  4. animal: 'cat',
  5. count: 2
  6. };
  7. var script = new vm.Script('count += 1; name = "kitty"');
  8. for (var i = 0; i < 10; ++i) {
  9. script.runInContext(sandbox);
  10. }
  11. console.log(util.inspect(sandbox));
  12. // { animal: 'cat', count: 12, name: 'kitty' }

注意,执行不被信任的代码是需要技巧且要非常的小心。

  1. script.runInContext
非常有用,不过想要安全些,最好还是在独立的进程里运行不被信任的代码。

script.runInNewContext([sandbox][, options])

  1. vm.runInNewContext
类似,只是作为预编译的
  1. Script
对象方法。若提供sandbox则script.runInNewContext将sandbox上下文化,若未提供,则创建一个新的上下文化的沙箱。

  1. script.runInNewContext
  1. script.runInThisContext
的参数类似。

例子:编译代码(设置了一个全局变量)并在不同的上下文里执行多次。这些全局变量会被保存在沙箱中。

  1. var util = require('util');
  2. var vm = require('vm');
  3. var sandboxes = [{}, {}, {}];
  4. var script = new vm.Script('globalVar = "set"');
  5. sandboxes.forEach(function (sandbox) {
  6. script.runInNewContext(sandbox);
  7. });
  8. console.log(util.inspect(sandboxes));
  9. // [{ globalVar: 'set' }, { globalVar: 'set' }, { globalVar: 'set' }]

注意,执行不被信任的代码是需要技巧且要非常的小心。

  1. script.runInNewContext
非常有用,不过想要安全些,最好还是在独立的进程里运行不被信任的代码。