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