Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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 &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ýsledok

innerHTML: 1 | A & B
textContent: 0 | <em>A &amp; 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

Zdroje