CKTIS / JavaScript
Escapovanie textu HTML a štrukturálna sanitizácia podľa zoznamu povolených položiek
Escapovanie znakov zobrazí vstup ako doslovný text. Štrukturálna sanitizácia zachová vybrané formátovanie podľa zoznamu povolených prvkov a atribútov.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.textContent = input;
element.setHTML(input, { sanitizer: { elements: ["strong"], attributes: [], comments: false, dataAttributes: false } });Keď vkladáš nedôveryhodný vstup do bežného textu v zdrojovom kóde HTML, zakóduj ho pre tento kontext: napríklad nahraď & za & a < za <. Analyzátor spracuje tieto odkazy ako textové znaky, nie ako syntax značiek. Ak pracuješ priamo s DOM, priraď pôvodnú hodnotu do textContent prvku, napríklad div: obsah sa nahradí textom bez parsovania HTML. Escapovanie textu HTML nie je všeobecnou ochranou pre atribúty, adresy URL, JavaScript ani CSS.
Ak chceš zachovať formátovanie, sanitizuj štruktúru. setHTML() parsuje fragment v kontexte cieľového prvku, uplatňuje zoznam povolených prvkov a atribútov a odstraňuje konštrukcie nebezpečné z hľadiska XSS, aj keď ich konfigurácia povoľuje. Pravidlá v príklade povoľujú strong, ale žiadne atribúty. Filtruj štruktúru po parsovaní namiesto odstraňovania značiek regulárnym výrazom. Ak pravidlá povoľujú odkazy, urči osobitne, ktoré adresy URL aplikácia prijíma.
textContent a setHTML() sú rozhrania webovej platformy, nie funkcie ECMAScriptu 2024. Over podporu setHTML() v cieľových prehliadačoch. Ak chýba, použi obyčajný text alebo overený sanitizátor HTML; neposielaj nespracovaný vstup do innerHTML. Ani pri serializovanom výsledku nepredpokladaj, že je bezpečné znova ho parsovať v inom kontexte: sanitizuj pri vložení do cieľového prvku.
Príklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>HTML text escaping and structural sanitization</title>
</head>
<body>
<pre id="output"></pre>
<script>
const input = '<strong title="label">A & B</strong><br>';
const text = document.createElement('div');
const rich = document.createElement('div');
if (typeof rich.setHTML !== 'function') {
throw new Error('This example requires a browser that supports Element.setHTML().');
}
text.textContent = input;
rich.setHTML(input, {
sanitizer: {
elements: ['strong'],
attributes: [],
comments: false,
dataAttributes: false,
},
});
document.getElementById('output').textContent =
[text.innerHTML, rich.innerHTML].join('\n');
</script>
</body>
</html>Výsledok
<strong title="label">A &amp; B</strong><br> <strong>A & B</strong>
Prvý riadok serializuje doslovný text: aj zápis `&` zo vstupu zostáva textom. Druhý ukazuje skutočný prvok `strong` bez atribútu `title` a bez prvku `br`. Príklad z `innerHTML` iba číta.
Súvisiace lekcie
- JavaScript · Lekcia 16 · Pokročilá · Verzia: 4