CKTIS / JavaScript
Element.innerHTML in varnostne meje pri vstavljanju besedila
Loči med razčlenjevanjem oznak in vstavljanjem dobesednega besedila. Nauči se preprečevati DOM XSS in razumi, kaj se spremeni ob uveljavljanju Trusted Types.
Različica: 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.Branje Element.innerHTML vrne serializirano vsebino elementa brez njegove zunanje oznake. Pri prirejanju v dokumentu HTML se fragment razčleni v kontekstu elementa in običajno nadomesti njegove obstoječe otroke. Pri elementu HTML <template> se ob branju serializira vsebina template.content, ob prirejanju pa se nadomestijo otroci tega objekta DocumentFragment, ne otroci samega elementa. Tudi element.innerHTML += fragment vozlišča nadomesti, namesto da bi za njimi dodal nova: najprej prebere serializirano vsebino in nato znova razčleni združeni niz.
Branje Node.textContent na elementu vrne združeno besedilo njegovih potomcev, ne njihovih oznak. Prirejanje nepraznega niza nadomesti otroke z enim besedilnim vozliščem, prazen niz pa jih odstrani. Če želiš obstoječe otroke obdržati, dodaj niz na konec z append(text) ali ga vstavi na izbrano mesto glede na element z insertAdjacentText(position, text). Nobena od teh besedilnih operacij ne interpretira oznak ali znakovnih sklicev v nizu.
Ne podajaj nezaupanja vrednih nizov v innerHTML: to je mesto za vbrizgavanje HTML, ki lahko povzroči DOM XSS. Tako vstavljeni elementi script se ne izvedejo, lahko pa kodo še vedno izvedejo drugi mehanizmi, na primer atributi za obravnavo dogodkov. Nezaupanja vredno besedilo prikaži v običajnem elementu, kot je div. Vstavljanje kot besedilo ne zagotavlja varne uporabe istih podatkov v kontekstu skripta, sloga ali URL-ja niti pri poznejšem razčlenjevanju kot HTML.
Če potrebuješ oblikovan HTML iz nezaupanja vrednega vira, uporabi setHTML(), kjer je podprt, ali HTML pred vstavljanjem očisti s preverjenim orodjem. Kot nadomestne rešitve nikoli ne uporabi prirejanja neočiščenega HTML v innerHTML. Če CSP zahteva Trusted Types in ni privzetega pravilnika, prirejanje navadnega niza v innerHTML sproži TypeError. TrustedHTML ne zagotavlja čiščenja: varnost je odvisna od pravilnika, ki je objekt ustvaril. To so API-ji spletne platforme, ne funkcionalnosti ECMAScripta. Preveri podporo za zaščite, ki jih uporabljaš.
Primeri
<!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>
Shrani primer kot datoteko HTML, odpri jo v brskalniku brez uveljavljanja Trusted Types in preveri izpis v konzoli brskalnika. Fiksni niz je neškodljiv: razčlenjevanje ustvari en element `em` in pretvori znakovni sklic v `&`. Vstavljanje kot besedilo ohrani celoten niz in ne ustvari nobenega otroškega elementa.
Povezane lekcije
- JavaScript · Lekcija 15 · Napredna · Različica: 4