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 sanitizerBezpeč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 = { "&": "&", "<": "<", ">": ">" };
return value.replace(/[&<>]/g, character => entities[character]);
}
const input = '<b>Hello</b> & "friends"';
const actual = escapeHtmlText(input);
const expected = '<b>Hello</b> & "friends"';
if (actual !== expected) {
throw new Error("Unexpected escaping result");
}
console.log(actual);Výsledek
<b>Hello</b> & "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.