Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Element.innerHTML i sigurnosne granice pri umetanju teksta

Razlikuj raščlanjivanje oznaka od umetanja doslovnog teksta. Nauči spriječiti DOM XSS i razumjeti što se mijenja kad se zahtijeva Trusted Types.

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

Sintaksa

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.

Čitanje Element.innerHTML vraća serijalizirani sadržaj elementa bez njegove vanjske oznake. Pri dodjeli u HTML dokumentu fragment se raščlanjuje u kontekstu elementa i obično zamjenjuje njegove postojeće čvorove djecu. Za HTML element <template> čitanje serijalizira sadržaj template.content, a dodjela zamjenjuje čvorove djecu tog objekta DocumentFragment, a ne samog elementa. I element.innerHTML += fragment zamjenjuje čvorove umjesto da iza njih dodaje nove: najprije čita serijalizirani sadržaj, a zatim ponovno raščlanjuje spojeni niz.

Čitanje Node.textContent na elementu vraća spojeni tekst njegovih potomaka, a ne njihove oznake. Dodjela nepraznog niza zamjenjuje djecu jednim tekstnim čvorom; prazan ih niz uklanja. Za zadržavanje postojeće djece dodaj niz na kraj pomoću append(text) ili ga umetni na odabrano mjesto u odnosu na element pomoću insertAdjacentText(position, text). Nijedna od tih tekstnih operacija ne tumači oznake ni znakovne reference u nizu.

Ne prosljeđuj nepouzdane nizove u innerHTML: to je mjesto za ubacivanje HTML-a koje može dovesti do DOM XSS-a. Tako umetnuti elementi script ne izvršavaju se, ali drugi mehanizmi, poput atributa za rukovanje događajima, i dalje mogu izvršiti kôd. Nepouzdan tekst prikaži u običnom elementu poput div. Umetanje u obliku teksta ne čini iste podatke sigurnima u kontekstu skripte, stila ili URL-a ni pri kasnijem raščlanjivanju kao HTML-a.

Ako trebaš formatirani HTML iz nepouzdanog izvora, koristi setHTML() ondje gdje je podržan ili očisti HTML provjerenim alatom prije umetanja. Kao zamjenu nikada ne dodjeljuj nepročišćeni HTML u innerHTML. Ako CSP zahtijeva Trusted Types, a nema zadane politike, dodjela običnog niza u innerHTML izaziva TypeError. TrustedHTML ne jamči čišćenje: sigurnost ovisi o politici koja je stvorila objekt. To su API-ji web-platforme, a ne značajke ECMAScripta; provjeri podršku za zaštite koje koristiš.

Primjeri

<!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>

Rezultat

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

Spremi primjer kao HTML datoteku, otvori je u pregledniku bez obvezne primjene Trusted Types i provjeri ispis u konzoli preglednika. Unaprijed zadani niz je bezopasan: raščlanjivanje stvara jedan element `em` i pretvara znakovnu referencu u `&`. Umetanje u obliku teksta čuva cijeli niz i ne stvara nijedan element dijete.

Povezane lekcije

  • JavaScript · Lekcija 15 · Napredno · Verzija: 4

Izvori