
مُجمّع قوالب Vue 2.7.16 المصحح مع إصلاحات لـ CVE‑2024‑6783 و CVE-2024-9506
نسخة مُصحّحة أمنيًا من vue-template-compiler لإصلاح ثغرة تلوث النموذج الأولي (CVE-2024-6783) وثغرة ReDoS (CVE-2024-9506).
مبنية على [email protected]. التطوير والمشكلات موجودة في vue-patched.
إذا كنت تستخدم نسخة Vue الكاملة (runtime + compiler) أو vue.js عبر CDN، فاستبدل أيضًا vue بـ vue-patched.
يمكن استخدام هذه الحزمة لترجمة قوالب Vue 2.0 مسبقًا إلى دوال render لتجنّب تكلفة الترجمة وقت التشغيل وقيود CSP. في معظم الحالات يجب استخدامها مع vue-loader، ولن تحتاج إليها بشكل منفصل إلا إذا كنت تكتب أدوات بناء ذات احتياجات محددة جدًا.
اختر طريقة التثبيت الأنسب لك.
تثبّت المترجم المُصحّح تحت الاسم الأصلي vue-template-compiler، بحيث تبقى تبعيات الـ peer مستوفاة ويستمر حلّ الحزم الحالي في العمل (مثلًا في @vue/test-utils).
npm install vue-template-compiler@npm:vue-template-compiler-patched@^2.7.16-patch.3 --save-dev
pnpm add vue-template-compiler@npm:vue-template-compiler-patched@^2.7.16-patch.3 --save-dev
yarn add vue-template-compiler@npm:vue-template-compiler-patched@^2.7.16-patch.3 --dev
يثبّت هذا المترجم باسم vue-template-compiler-patched. استخدم هذه الطريقة إذا كنت تحتاج فقط إلى الوصول المباشر إلى البناء المُرقّع. لن تكتشفه الأدوات التي تحلّ vue-template-compiler حسب اسم الحزمة.
npm install vue-template-compiler-patched --save-dev
pnpm add vue-template-compiler-patched --save-dev
yarn add vue-template-compiler-patched --dev
import compiler from 'vue-template-compiler-patched'
// or: const compiler = require('vue-template-compiler-patched')
يُجمّع سلسلة قالب ويعيد شيفرة JavaScript مُجمّعة. النتيجة المُعادة هي كائن بالصيغة التالية:
{
ast: ?ASTElement, // parsed template elements to AST
render: string, // main render function code
staticRenderFns: Array<string>, // render code for static sub trees, if any
errors: Array<string> // template syntax errors, if any
}
لاحظ أن كود الدالة المُعاد يستخدم with وبالتالي لا يمكن استخدامه في كود الوضع الصارم.
outputSourceRange جديد في 2.6
booleanfalseضبط هذا الخيار على true سيجعل errors المُعادة في النتيجة المُجمَّعة تصبح كائنات بالشكل { msg, start, end }. الخاصيتان start وend هما رقمان يحددان نطاق الكود لمصدر الخطأ في القالب. يمكن تمرير ذلك إلى واجهة compiler.generateCodeFrame لتوليد إطار كود للخطأ.
whitespace
string'preserve' | 'condense''preserve'تتعامل القيمة الافتراضية 'preserve' مع المسافات البيضاء على النحو التالي:
إذا ضُبطت على 'condense':
سيؤدي استخدام وضع condense إلى حجم كود مُجمَّع أصغر وأداء مُحسَّن قليلًا. ومع ذلك، سينتج فروقًا طفيفة في التخطيط البصري مقارنة بـ HTML العادي في حالات معينة.
لا يؤثر هذا الخيار على وسم <pre>.
مثال:
<!-- source -->
<div>
<span>
foo
</span> <span>bar</span>
</div>
<!-- whitespace: 'preserve' -->
<div> <span>
foo
</span> <span>bar</span> </div>
<!-- whitespace: 'condense' -->
<div><span> foo </span> <span>bar</span></div>
modules
من الممكن الربط بعملية الترجمة (compilation) لدعم ميزات قوالب مخصصة. ومع ذلك، احذر من أنه عبر حقن وحدات (modules) مخصصة وقت الترجمة، فإن قوالبك لن تعمل مع أدوات بناء أخرى مبنية على الوحدات المدمجة القياسية، مثل vue-loader وvueify.
مصفوفة من وحدات المترجم (compiler modules). للحصول على تفاصيل حول وحدات المترجم، راجع نوع ModuleOptions في تعريفات flow والوحدات المدمجة.
directives
كائن يكون فيه المفتاح هو اسم التوجيه (directive) والقيمة دالة تقوم بتحويل عقدة AST للقالب. على سبيل المثال:
compiler.compile('<div v-test></div>', {
directives: {
test (node, directiveMeta) {
// transform node based on directiveMeta
}
}
})
بشكل افتراضي، ستستخرج توجيهة وقت الترجمة التوجيهة ولن تكون التوجيهة موجودة في وقت التشغيل. إذا كنت تريد أن تُعالَج التوجيهة أيضًا بواسطة تعريف وقت التشغيل، فأعد true في دالة التحويل.
راجع تنفيذ بعض التوجيهات المدمجة لوقت الترجمة.
preserveWhitespace مهمل منذ 2.6
booleantrueبشكل افتراضي، تحافظ دالة العرض المترجمة على جميع أحرف المسافات البيضاء بين وسوم HTML. إذا تم ضبطها على false، فسيتم تجاهل المسافات البيضاء بين الوسوم. قد يؤدي هذا إلى أداء أفضل قليلًا لكنه قد يؤثر على التخطيط للعناصر المضمنة.
مشابه لـ compiler.compile، لكنه يعيد دوالًا مُنشأة مباشرة:
{
render: Function,
staticRenderFns: Array<Function>
}
هذا مفيد فقط في وقت التشغيل مع عمليات بناء مُعدّة مسبقًا، لذا لا يقبل أي خيارات وقت الترجمة. بالإضافة إلى ذلك، تستخدم هذه الطريقة new Function() لذا فهي غير متوافقة مع CSP.
2.4.0+
مثل compiler.compile لكنه يولّد كود دالة عرض خاص بـ SSR عبر تحسين أجزاء من القالب إلى دمج سلاسل نصية من أجل تحسين أداء SSR.
يُستخدم هذا افتراضيًا في vue-loader@>=12 ويمكن تعطيله باستخدام خيار optimizeSSR.
2.4.0+
مثل compiler.compileToFunction لكنه يولّد كود دالة عرض خاص بـ SSR عبر تحسين أجزاء من القالب إلى دمج سلاسل نصية من أجل تحسين أداء SSR.
يحلّل مكوّن SFC (مكوّن ملف واحد، أو ملف *.vue) إلى واصف (راجع نوع SFCDescriptor في تعريفات flow). يُستخدم هذا في أدوات بناء SFC مثل vue-loader وvueify.
يولّد إطار كود يُبرز الجزء في template المحدد بواسطة start وend. مفيد للإبلاغ عن الأخطاء في الأدوات عالية المستوى.
padيكون pad مفيدًا عندما تقوم بتوجيه المحتوى المستخرج إلى معالجات مسبقة أخرى، حيث ستحصل على أرقام أسطر أو مؤشرات أحرف صحيحة في حال وجود أي أخطاء نحوية.
{ pad: "line" }، سيُسبق المحتوى المستخرج لكل كتلة بسطر جديد واحد لكل سطر في المحتوى السابق من الملف الأصلي لضمان محاذاة أرقام الأسطر مع الملف الأصلي.{ pad: "space" }، سيُسبق المحتوى المستخرج لكل كتلة بمسافة واحدة لكل حرف في المحتوى السابق من الملف الأصلي لضمان بقاء عدد الأحرف مطابقًا للملف الأصلي.