Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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 &amp; a < za &lt;. 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 &amp; 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

&lt;strong title="label"&gt;A &amp;amp; B&lt;/strong&gt;&lt;br&gt;
<strong>A &amp; B</strong>

Prvý riadok serializuje doslovný text: aj zápis `&amp;` 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

Zdroje