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

CKTIS / JavaScript

Element.innerHTML a hranice bezpečnosti při vkládání textu

Rozlišuj zpracování značek od vkládání doslovného textu. Zjisti, jak předcházet DOM XSS a co se změní, když se vynucují Trusted Types.

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

Syntaxe

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.

Čtení Element.innerHTML vrací serializovaný obsah elementu bez jeho vlastní značky. Při přiřazení v dokumentu HTML se fragment zpracuje v kontextu elementu a obvykle nahradí jeho stávající podřízené uzly. U HTML elementu <template> se při čtení serializuje obsah template.content a při přiřazení se nahradí podřízené uzly tohoto objektu DocumentFragment, nikoli samotného elementu. Také element.innerHTML += fragment uzly nahrazuje, místo aby za ně přidával další: nejprve přečte serializovaný obsah a pak znovu zpracuje celý spojený řetězec.

Čtení Node.textContent na elementu vrací spojený text jeho potomků, nikoli jejich značky. Přiřazení neprázdného řetězce nahradí podřízené uzly jedním textovým uzlem; prázdný řetězec je odstraní. Pokud je chceš zachovat, přidej řetězec na konec pomocí append(text) nebo ho vlož na zvolené místo vzhledem k elementu pomocí insertAdjacentText(position, text). Žádná z těchto textových operací neinterpretuje značky ani znakové reference v řetězci.

Nepředávej nedůvěryhodné řetězce do innerHTML: jde o místo pro injekci HTML, která může vést k DOM XSS. Takto vložené elementy script se nespustí, ale jiné mechanismy, například atributy obsluhy událostí, mohou kód stále spustit. Nedůvěryhodný text zobrazuj v běžném elementu, jako je div. Vložení jako text nezaručí bezpečnost stejných dat v kontextu skriptu, stylu nebo URL ani při jejich pozdější interpretaci jako HTML.

Pokud potřebuješ formátované HTML z nedůvěryhodného zdroje, použij setHTML() tam, kde je podporováno, nebo HTML před vložením očisti ověřeným nástrojem. Nikdy jako náhradu nepřiřazuj neočištěné HTML přímo do innerHTML. Pokud CSP vynucuje Trusted Types a není definována výchozí politika, přiřazení běžného řetězce do innerHTML vyvolá TypeError. TrustedHTML nezaručuje očištění: bezpečnost závisí na politice, která objekt vytvořila. Jde o API webové platformy, ne o funkce ECMAScriptu; ověř podporu používaných ochran.

Příklady

<!doctype html>
<meta charset="utf-8">
<title>innerHTML and textContent</title>
<script>
{
  const sample = "<em>A &amp; 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ýsledek

innerHTML: 1 | A & B
textContent: 0 | <em>A &amp; B</em>

Ulož příklad jako soubor HTML, otevři ho v prohlížeči bez vynucování Trusted Types a zkontroluj výstup v konzoli prohlížeče. Pevně zadaný řetězec je neškodný: zpracování vytvoří jeden element `em` a znakovou referenci převede na `&`. Vložení jako text zachová celý řetězec a nevytvoří žádný podřízený element.

Související lekce

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

Zdroje