Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Escapování textu HTML a strukturální sanitizace podle seznamu povolených položek

Escapování znaků zobrazí vstup jako doslovný text. Strukturální sanitizace zachová vybrané formátování podle seznamu povolených prvků a atributů.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

element.textContent = input;
element.setHTML(input, { sanitizer: { elements: ["strong"], attributes: [], comments: false, dataAttributes: false } });

Když vkládáš nedůvěryhodný vstup do běžného textu ve zdrojovém kódu HTML, zakóduj ho pro tento kontext: například nahraď & za &amp; a < za &lt;. Analyzátor tyto odkazy vyhodnotí jako textové znaky, nikoli jako syntaxi značek. Pokud pracuješ přímo s DOM, přiřaď původní hodnotu do textContent prvku, například div: jeho obsah se nahradí textem bez parsování HTML. Escapování textu HTML není obecnou ochranou pro atributy, adresy URL, JavaScript ani CSS.

Pokud chceš zachovat formátování, sanitizuj strukturu. setHTML() parsuje fragment v kontextu cílového prvku, uplatňuje seznam povolených prvků a atributů a odstraňuje konstrukce nebezpečné z hlediska XSS, i když je konfigurace povoluje. Pravidla v příkladu povolují strong, ale žádné atributy. Filtruj strukturu po parsování namísto odstraňování značek regulárním výrazem. Povolují-li pravidla odkazy, stanov zvlášť, které adresy URL aplikace přijímá.

textContent a setHTML() jsou rozhraní webové platformy, nikoli funkce ECMAScriptu 2024. Ověř podporu setHTML() v cílových prohlížečích. Pokud chybí, použij prostý text nebo prověřený sanitizátor HTML; nepředávej nezpracovaný vstup do innerHTML. Ani u serializovaného výsledku nepředpokládej, že ho lze bezpečně znovu parsovat v jiném kontextu: sanitizuj při vložení do cílového prvku.

Pří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ýsledek

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

První řádek serializuje doslovný text: i zápis `&amp;` ze vstupu zůstává textem. Druhý ukazuje skutečný prvek `strong` bez atributu `title` a bez prvku `br`. Příklad z `innerHTML` pouze čte.

Související lekce

  • JavaScript · Lekce 16 · Pokročilá · Verze: 4

Zdroje