
Entorno de pruebas (sandbox) de Node.js para ejecutar JavaScript no confiable en el mismo proceso, utilizando Proxies y un require controlado para restringir el acceso a módulos integrados y externos.
vm2 es un sandbox que puede ejecutar código no confiable con los módulos integrados de Node incluidos en una lista blanca.
Para una mirada en profundidad al funcionamiento interno de vm2, consulta el archivo CONTRIBUTING.md.
Pruébalo tú mismo:
import { runInNewContext } from "node:vm";
runInNewContext('this.constructor.constructor("return process")().exit()');
console.log('Never gets executed.');
import { VM } from 'vm2';
new VM().run('this.constructor.constructor("return process")().exit()');
// Throws ReferenceError: process is not defined
npm install vm2
import { VM } from 'vm2';
const vm = new VM();
vm.run(`process.exit()`); // TypeError: process.exit is not a function
import { NodeVM } from 'vm2';
const vm = new NodeVM({
require: {
external: true,
root: './',
},
});
vm.run(
`
var request = require('request');
request('http://www.google.com', function (error, response, body) {
console.error(error);
if (!error && response.statusCode == 200) {
console.log(body); // Show the HTML for the Google homepage.
}
});
`,
'vm.js',
);
VM es un sandbox simple para ejecutar código no confiable de forma síncrona sin la característica require. Solo están disponibles los objetos integrados de JavaScript y el Buffer de Node. Las funciones de programación (setInterval, setTimeout y setImmediate) no están disponibles por defecto.
Opciones:
timeout - Tiempo de espera del script en milisegundos. ADVERTENCIA: Es posible que desees usar esta opción junto con allowAsync=false. Además, operar sobre los objetos devueltos desde el sandbox puede ejecutar código arbitrario y eludir el tiempo de espera. En el otro caso, se debería comprobar si el objeto devuelto es un primitivo con typeof y descartarlo por completo (realizar logging o crear mensajes de error con dicho objeto también podría ejecutar código arbitrario de nuevo).sandbox - Objeto global de VM.compiler - javascript (por defecto), typescript, coffeescript o una función de compilador personalizada. La biblioteca espera que tengas el compilador preinstalado si el valor se establece en typescript o coffeescript.eval - Si se establece en false, cualquier llamada a eval o a constructores de funciones (Function, GeneratorFunction, etc.) lanzará un EvalError (por defecto: true).wasm - Si se establece en false, cualquier intento de compilar un módulo WebAssembly lanzará un WebAssembly.CompileError (por defecto: true).allowAsync - Si se establece en false, cualquier intento de ejecutar código usando async lanzará un VMError (por defecto: true).IMPORTANTE: El tiempo de espera solo es efectivo en código síncrono que ejecutes a través de run. El tiempo de espera NO funciona en ningún método devuelto por VM. Hay algunas situaciones en las que el tiempo de espera no funciona; consulta #244.
import { VM } from 'vm2';
const vm = new VM({
timeout: 1000,
allowAsync: false,
sandbox: {},
});
vm.run('process.exit()'); // throws ReferenceError: process is not defined
También puedes recuperar valores de la VM.
let number = vm.run('1337'); // returns 1337
CONSEJO: Consulta las pruebas para ver más ejemplos de uso.
A diferencia de VM, NodeVM te permite requerir módulos de la misma manera que lo harías en el contexto habitual de Node.
Opciones: