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

CKTIS / JavaScript

Bezpečnostní hranice: escapování textu HTML a sanitizace

Bezpečnostní hranice odděluje nedůvěryhodná data od operací, které jim dávají význam nebo oprávnění. Poznejte rozdíl mezi escapováním textu HTML a sanitizací pomocí seznamu povolených prvků i omezení malého příkladu escapování v JavaScriptu.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

escapeHtmlText(value); // HTML text context only; not an HTML sanitizer

Bezpečnostní hranice (security boundaries) je místo, kde se data s nižší mírou důvěry dostanou k operaci, která je může interpretovat jako kód nebo značky. Vstup se nestává důvěryhodným jen proto, že jde o řetězec JavaScriptu. ECMAScript definuje jazyk, zatímco parsování HTML a ochrana prohlížeče patří do hostitelského prostředí; dodaná specifikace není standardem sanitizace HTML.

Escapování textu HTML oproti sanitizaci pomocí seznamu povolených prvků: při escapování se speciální znaky nahrazují znakovými referencemi, takže se obsah zpracuje jako text, nikoli jako značky. Sanitizace má jiný účel: povoluje vybrané značky a odstraňuje nebo odmítá nepovolené prvky, atributy a nebezpečné hodnoty URL. Nenahrazujte sanitizátor jednoduchým regulárním výrazem, který odstraňuje značky.

Funkce escapeHtmlText přijímá řetězec a v jednom průchodu escapuje &, < a >. Je určena výhradně pro běžný textový kontext HTML, nikoli pro atributy, URL, JavaScript, CSS ani obsah prvků script a style. Uvozovky záměrně ponechává beze změny. Výsledkem není „bezpečné HTML“ pro libovolné použití; opětovné escapování již escapovaného výsledku jej znovu změní.

Příklad ověřuje pouze deterministickou transformaci řetězce a nevyžaduje API prohlížeče. Neznázorňuje vykreslení ani neověřuje sanitizátor. Aplikace, která potřebuje zachovat formátování HTML, vyžaduje samostatně zvolenou a ověřenou zásadu sanitizace. Spuštění kódu v Node.js nedokazuje dostupnost ani bezpečnost API prohlížeče.

Příklady

function escapeHtmlText(value) {
  const entities = { "&": "&amp;", "<": "&lt;", ">": "&gt;" };
  return value.replace(/[&<>]/g, character => entities[character]);
}

const input = '<b>Hello</b> & "friends"';
const actual = escapeHtmlText(input);
const expected = '&lt;b&gt;Hello&lt;/b&gt; &amp; "friends"';
if (actual !== expected) {
  throw new Error("Unexpected escaping result");
}
console.log(actual);

Výsledek

&lt;b&gt;Hello&lt;/b&gt; &amp; "friends"

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje