
Bac à sable Node.js exécutant du JavaScript non fiable dans le même processus, avec des Proxies et une fonction require contrôlée pour restreindre l’accès aux modules intégrés et externes.
vm2 est un bac à sable capable d’exécuter du code non fiable avec une liste autorisée de modules intégrés de Node.
Pour une présentation détaillée du fonctionnement interne de vm2, consultez le fichier CONTRIBUTING.md.
Essayez vous-même :
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 est un bac à sable simple qui exécute du code non fiable de manière synchrone, sans la fonction require. Seuls les objets intégrés de JavaScript et le Buffer de Node sont disponibles. Les fonctions de planification (setInterval, setTimeout et setImmediate) ne sont pas disponibles par défaut.
Options :
timeout - Délai maximal du script en millisecondes. AVERTISSEMENT : il peut être utile de combiner cette option avec allowAsync=false. De plus, manipuler les objets renvoyés par le bac à sable peut exécuter du code arbitraire et contourner ce délai. Il faut vérifier avec typeof que l’objet renvoyé est une valeur primitive et, dans le cas contraire, l’ignorer entièrement (même la journalisation ou la création de messages d’erreur avec cet objet peut à nouveau exécuter du code arbitraire).sandbox - Objet global de la VM.compiler - javascript (par défaut), typescript, coffeescript ou fonction de compilation personnalisée. La bibliothèque suppose que le compilateur est déjà installé si la valeur est typescript ou coffeescript.eval - Avec la valeur false, tout appel à eval ou aux constructeurs de fonctions (Function, GeneratorFunction, etc.) lève une EvalError (par défaut : true).wasm - Avec la valeur false, toute tentative de compilation d’un module WebAssembly lève une WebAssembly.CompileError (par défaut : true).allowAsync - Avec la valeur false, toute tentative d’exécution de code async lève une VMError (par défaut : true).IMPORTANT : le délai maximal ne s’applique qu’au code synchrone exécuté avec run. Il ne fonctionne PAS pour les méthodes renvoyées par VM. Il existe des situations dans lesquelles ce délai ne fonctionne pas : voir #244.
import { VM } from 'vm2';
const vm = new VM({
timeout: 1000,
allowAsync: false,
sandbox: {},
});
vm.run('process.exit()'); // throws ReferenceError: process is not defined
Vous pouvez également récupérer des valeurs depuis VM.
let number = vm.run('1337'); // returns 1337
CONSEIL : consultez les tests pour d’autres exemples d’utilisation.
Contrairement à VM, NodeVM permet de charger des modules comme dans le contexte habituel de Node.
Options :