
بيئة Node.js معزولة لتشغيل JavaScript غير موثوق داخل العملية نفسها، باستخدام Proxies وrequire المُتحكَّم به لتقييد الوصول إلى الوحدات المدمجة والخارجية.
vm2 هو صندوق رمل يمكنه تشغيل تعليمات برمجية غير موثوقة مع وحدات Node.js المدمجة المدرجة في القائمة البيضاء.
للاطلاع على تفاصيل أعمق حول البنية الداخلية لـ vm2، راجع ملف CONTRIBUTING.md.
جرب ذلك بنفسك:
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 هي بيئة عزل بسيطة لتشغيل التعليمات البرمجية غير الموثوقة بشكل متزامن دون ميزة require. لا تتوفر سوى كائنات JavaScript المدمجة وBuffer الخاصة بـ Node. دوال الجدولة (setInterval وsetTimeout وsetImmediate) غير متاحة افتراضيًا.
الخيارات:
timeout - مهلة السكربت بالمللي ثانية. تحذير: قد ترغب في استخدام هذا الخيار مع allowAsync=false. علاوة على ذلك، فإن التعامل مع الكائنات المُعادة من بيئة العزل يمكن أن يشغّل تعليمات برمجية عشوائية ويتجاوز المهلة. ينبغي للمرء اختبار ما إذا كان الكائن المُعاد قيمة أولية باستخدام typeof والتخلص منه بالكامل (فإن إجراء التسجيل أو إنشاء رسائل خطأ باستخدام مثل هذا الكائن قد يشغّل أيضًا تعليمات برمجية عشوائية مرة أخرى) في الحالة الأخرى.sandbox - الكائن العام لـ VM.compiler - javascript (افتراضي)، أو typescript، أو coffeescript، أو دالة مترجم مخصصة. تتوقع المكتبة أن يكون المترجم مثبتًا مسبقًا إذا كانت القيمة مضبوطة على typescript أو coffeescript.eval - إذا ضُبطت على false، فإن أي استدعاءات لـ eval أو دوال البناء (Function، GeneratorFunction، إلخ) ستُطلق EvalError (افتراضي: true).wasm - إذا ضُبطت على false، فإن أي محاولة لتجميع وحدة WebAssembly ستُطلق WebAssembly.CompileError (افتراضي: true).allowAsync - إذا ضُبطت على false، فإن أي محاولة لتشغيل تعليمات برمجية باستخدام async ستُطلق VMError (افتراضي: true).مهم: المهلة فعّالة فقط على التعليمات البرمجية المتزامنة التي تشغّلها عبر run. المهلة لا تعمل على أي دالة تُعيدها VM. هناك بعض الحالات التي لا تعمل فيها المهلة - انظر #244.
import { VM } from 'vm2';
const vm = new VM({
timeout: 1000,
allowAsync: false,
sandbox: {},
});
vm.run('process.exit()'); // throws ReferenceError: process is not defined
يمكنك أيضًا استرداد القيم من VM.
let number = vm.run('1337'); // returns 1337
نصيحة: راجع الاختبارات للحصول على المزيد من أمثلة الاستخدام.
على عكس VM، يتيح لك NodeVM استدعاء الوحدات (require) بالطريقة نفسها التي تفعلها في سياق Node العادي.
الخيارات: