
CVE‑2024‑6783 और CVE-2024-9506 के लिए फिक्स के साथ पैच किया गया Vue 2.7.16 टेम्पलेट कंपाइलर
vue-template-compiler का एक सुरक्षा-पैच किया गया संस्करण, जो prototype pollution कमजोरी (CVE-2024-6783) और ReDoS कमजोरी (CVE-2024-9506) को ठीक करता है।
[email protected] पर आधारित। विकास और समस्याएँ vue-patched में रहती हैं।
यदि आप Vue के पूर्ण बिल्ड (runtime + compiler) या CDN vue.js का उपयोग करते हैं, तो vue को भी vue-patched से बदलें।
इस पैकेज का उपयोग Vue 2.0 टेम्पलेट्स को render functions में पहले से कंपाइल करने के लिए किया जा सकता है, ताकि runtime-compilation के ओवरहेड और CSP प्रतिबंधों से बचा जा सके। अधिकांश मामलों में आपको इसे vue-loader के साथ उपयोग करना चाहिए; आपको इसकी अलग से आवश्यकता केवल तब होगी जब आप बहुत विशिष्ट आवश्यकताओं वाले build tools लिख रहे हों।
वह इंस्टॉलेशन दृष्टिकोण चुनें जो आपके लिए सबसे उपयुक्त हो।
पैच किए गए कंपाइलर को मूल vue-template-compiler नाम के अंतर्गत इंस्टॉल करता है, ताकि peer dependencies संतुष्ट रहें और मौजूदा package lookups हल होती रहें (जैसे @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 का उपयोग करता है और इसलिए इसे strict mode कोड में उपयोग नहीं किया जा सकता।
outputSourceRange 2.6 में नया
booleanfalseइसे true पर सेट करने से संकलित परिणाम में लौटाए गए errors { msg, start, end } के रूप में ऑब्जेक्ट बन जाएंगे। start और end प्रॉपर्टी ऐसी संख्याएँ हैं जो टेम्पलेट में त्रुटि स्रोत की कोड रेंज को चिह्नित करती हैं। इसे त्रुटि के लिए कोड फ़्रेम उत्पन्न करने हेतु compiler.generateCodeFrame API को पास किया जा सकता है।
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
कस्टम टेम्पलेट सुविधाओं का समर्थन करने के लिए कंपाइलेशन प्रक्रिया में हुक करना संभव है। हालाँकि, सावधान रहें कि कस्टम कंपाइल-टाइम मॉड्यूल इंजेक्ट करके, आपके टेम्पलेट मानक अंतर्निहित मॉड्यूल पर बने अन्य बिल्ड टूल्स, जैसे vue-loader और vueify, के साथ काम नहीं करेंगे।
कंपाइलर मॉड्यूल की एक सरणी। कंपाइलर मॉड्यूल के विवरण के लिए, flow declarations में ModuleOptions प्रकार और built-in modules देखें।
directives
एक ऑब्जेक्ट जिसमें key डायरेक्टिव का नाम है और value एक फ़ंक्शन है जो टेम्पलेट 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 फ़ाइल) को एक डिस्क्रिप्टर में पार्स करें (flow declarations में SFCDescriptor प्रकार देखें)। यह vue-loader और vueify जैसे SFC बिल्ड टूल्स में उपयोग किया जाता है।
एक कोड फ़्रेम उत्पन्न करें जो template में start और end द्वारा परिभाषित भाग को हाइलाइट करता है। उच्च-स्तरीय टूलींग में त्रुटि रिपोर्टिंग के लिए उपयोगी।
padpad तब उपयोगी होता है जब आप निकाले गए कंटेंट को अन्य प्री-प्रोसेसर में पाइप कर रहे हों, क्योंकि किसी भी सिंटैक्स त्रुटि होने पर आपको सही पंक्ति संख्याएँ या वर्ण इंडेक्स मिलेंगे।