
Compilatore di template Vue 2.7.16 con patch per CVE‑2024‑6783 e CVE-2024-9506
Una versione di vue-template-compiler con patch di sicurezza per correggere la vulnerabilità di prototype pollution (CVE-2024-6783) e la vulnerabilità ReDoS (CVE-2024-9506).
Basato su [email protected]. Lo sviluppo e le segnalazioni risiedono in vue-patched.
Se utilizzi la build completa di Vue (runtime + compiler) o il CDN vue.js, sostituisci anche vue con vue-patched.
Questo pacchetto può essere utilizzato per pre-compilare i template di Vue 2.0 in funzioni di render per evitare l'overhead della compilazione a runtime e le restrizioni CSP. Nella maggior parte dei casi dovresti usarlo con vue-loader; ti servirà separatamente solo se stai scrivendo strumenti di build con esigenze molto specifiche.
Scegli l'approccio di installazione che fa per te.
Installa il compilatore con patch sotto il nome originale vue-template-compiler, in modo che le peer dependency rimangano soddisfatte e le ricerche dei pacchetti esistenti continuino a risolversi (ad es. in @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
Installa il compilatore come vue-template-compiler-patched. Usa questo metodo se hai solo bisogno di un accesso diretto alla build patchata. Gli strumenti che risolvono vue-template-compiler tramite il nome del pacchetto non lo rileveranno.
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')
Compila una stringa di template e restituisce il codice JavaScript compilato. Il risultato restituito è un oggetto nel seguente formato:
{
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
}
Nota che il codice della funzione restituito utilizza with e pertanto non può essere usato in codice in modalità strict.
outputSourceRange novità nella 2.6
booleanfalseImpostandolo su true, gli errors restituiti nel risultato compilato diventeranno oggetti nella forma { msg, start, end }. Le proprietà start e end sono numeri che indicano l'intervallo di codice della sorgente dell'errore nel template. Questo può essere passato all'API compiler.generateCodeFrame per generare un code frame per l'errore.
whitespace
string'preserve' | 'condense''preserve'Il valore predefinito 'preserve' gestisce gli spazi bianchi come segue:
Se impostato su 'condense':
L'utilizzo della modalità condense produrrà un codice compilato di dimensioni inferiori e prestazioni leggermente migliori. Tuttavia, in alcuni casi produrrà lievi differenze nel layout visivo rispetto all'HTML semplice.
Questa opzione non influisce sul tag <pre>.
Esempio:
<!-- 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
È possibile agganciarsi al processo di compilazione per supportare funzionalità personalizzate dei template. Tuttavia, attenzione: iniettando moduli personalizzati in fase di compilazione, i tuoi template non funzioneranno con altri strumenti di build basati sui moduli standard integrati, ad es. vue-loader e vueify.
Un array di moduli del compilatore. Per dettagli sui moduli del compilatore, fare riferimento al tipo ModuleOptions nelle dichiarazioni flow e ai moduli integrati.
directives
Un oggetto in cui la chiave è il nome della direttiva e il valore è una funzione che trasforma un nodo AST del template. Ad esempio:
compiler.compile('<div v-test></div>', {
directives: {
test (node, directiveMeta) {
// transform node based on directiveMeta
}
}
})
Per impostazione predefinita, una direttiva di compilazione estrae la direttiva e la direttiva non sarà presente in fase di esecuzione. Se vuoi che la direttiva sia gestita anche da una definizione di runtime, restituisci true nella funzione di trasformazione.
Fai riferimento all'implementazione di alcune direttive di compilazione integrate.
preserveWhitespace Deprecato dalla 2.6
booleantruePer impostazione predefinita, la funzione di rendering compilata preserva tutti i caratteri di spaziatura tra i tag HTML. Se impostato su false, la spaziatura tra i tag verrà ignorata. Ciò può comportare prestazioni leggermente migliori ma potrebbe influire sul layout degli elementi inline.
Simile a compiler.compile, ma restituisce direttamente le funzioni istanziate:
{
render: Function,
staticRenderFns: Array<Function>
}
Questo è utile solo in fase di esecuzione con build preconfigurate, quindi non accetta alcuna opzione in fase di compilazione. Inoltre, questo metodo utilizza new Function() e quindi non è conforme a CSP.
2.4.0+
Come compiler.compile ma genera codice per funzioni di render specifiche per SSR ottimizzando parti del template in concatenazione di stringhe al fine di migliorare le prestazioni SSR.
Questo è utilizzato per impostazione predefinita in vue-loader@>=12 e può essere disabilitato usando l'opzione optimizeSSR.
2.4.0+
Come compiler.compileToFunction ma genera codice per funzioni di render specifiche per SSR ottimizzando parti del template in concatenazione di stringhe al fine di migliorare le prestazioni SSR.
Analizza un SFC (componente a file singolo, o file *.vue) in un descrittore (fare riferimento al tipo SFCDescriptor nelle dichiarazioni flow). Questo è utilizzato in strumenti di build per SFC come vue-loader e vueify.