CKTIS / JavaScript
Element.innerHTML a hranice bezpečnosti pri vkladaní textu
Rozlišuj spracovanie značiek od vkladania doslovného textu. Zisti, ako predchádzať DOM XSS a čo sa zmení pri vynucovaní Trusted Types.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const markup = element.innerHTML;
element.innerHTML = htmlStringOrTrustedHTML;
const text = element.textContent;
element.textContent = plainText;
element.append(plainText);
element.insertAdjacentText("beforeend", plainText);
element.setHTML(htmlToSanitize); // Where supported.Čítanie Element.innerHTML vráti serializovaný obsah elementu bez jeho vlastnej značky. Pri priradení v dokumente HTML sa fragment spracuje v kontexte elementu a zvyčajne nahradí jeho existujúce podriadené uzly. Pri HTML elemente <template> sa pri čítaní serializuje obsah template.content a pri priradení sa nahradia podriadené uzly tohto objektu DocumentFragment, nie samotného elementu. Aj element.innerHTML += fragment uzly nahrádza namiesto toho, aby za ne pridalo ďalšie: najprv prečíta serializovaný obsah a potom opäť spracuje celý spojený reťazec.
Čítanie Node.textContent na elemente vráti spojený text jeho potomkov, nie ich značky. Priradenie neprázdneho reťazca nahradí podriadené uzly jedným textovým uzlom; prázdny reťazec ich odstráni. Ak ich chceš zachovať, pridaj reťazec na koniec cez append(text) alebo ho vlož na zvolené miesto vzhľadom na element cez insertAdjacentText(position, text). Žiadna z týchto textových operácií neinterpretuje značky ani znakové referencie v reťazci.
Neposielaj nedôveryhodné reťazce do innerHTML: je to miesto na injekciu HTML, ktorá môže viesť k DOM XSS. Takto vložené elementy script sa nespustia, no iné mechanizmy, napríklad atribúty obsluhy udalostí, môžu stále spustiť kód. Nedôveryhodný text zobrazuj v bežnom elemente, ako je div. Vloženie ako text nezaručí bezpečnosť tých istých údajov v kontexte skriptu, štýlu alebo URL ani pri ich neskoršej interpretácii ako HTML.
Ak potrebuješ formátované HTML z nedôveryhodného zdroja, použi setHTML() tam, kde je podporované, alebo HTML pred vložením očisti overeným nástrojom. Nikdy ako náhradu nepriraďuj neočistené HTML priamo do innerHTML. Ak CSP vynucuje Trusted Types a chýba predvolená politika, priradenie obyčajného reťazca do innerHTML vyvolá TypeError. TrustedHTML nezaručuje očistenie: bezpečnosť závisí od politiky, ktorá objekt vytvorila. Ide o API webovej platformy, nie o funkcie ECMAScriptu; over si podporu používaných ochranných mechanizmov.
Príklady
<!doctype html>
<meta charset="utf-8">
<title>innerHTML and textContent</title>
<script>
{
const sample = "<em>A & B</em>";
const parsed = document.createElement("div");
const literal = document.createElement("div");
parsed.innerHTML = sample;
literal.textContent = sample;
console.log(`innerHTML: ${parsed.childElementCount} | ${parsed.textContent}`);
console.log(`textContent: ${literal.childElementCount} | ${literal.textContent}`);
}
</script>Výsledok
innerHTML: 1 | A & B textContent: 0 | <em>A & B</em>
Ulož príklad ako súbor HTML, otvor ho v prehliadači bez vynucovania Trusted Types a skontroluj výstup v konzole prehliadača. Pevne zadaný reťazec je neškodný: spracovanie vytvorí jeden element `em` a znakovú referenciu prevedie na `&`. Vloženie ako text zachová celý reťazec a nevytvorí žiadny podriadený element.
Súvisiace lekcie
- JavaScript · Lekcia 15 · Pokročilá · Verzia: 4