CKTIS / JavaScript
Element.innerHTML en veiligheidsgrenzen bij tekstinvoeging
Kies tussen het parsen van opmaak en het invoegen van letterlijke tekst. Leer hoe je DOM-XSS voorkomt en wat er verandert als Trusted Types wordt afgedwongen.
Versie: 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.Bij het uitlezen van Element.innerHTML krijg je de geserialiseerde inhoud van het element, zonder de eigen tag. Bij een toewijzing in een HTML-document wordt een fragment in de context van het element geparseerd en worden doorgaans de bestaande kindknopen vervangen. Bij een HTML-element <template> serialiseert het uitlezen de inhoud van template.content, terwijl een toewijzing de kindknopen van dat DocumentFragment vervangt, niet die van het element zelf. Ook element.innerHTML += fragment vervangt knopen in plaats van er nieuwe achter te plaatsen: het leest de geserialiseerde inhoud en parset daarna de samengevoegde tekenreeks opnieuw.
Bij een element geeft Node.textContent de samengevoegde tekst van de afstammelingen terug, niet hun opmaak. Toewijzing van een niet-lege tekenreeks vervangt de kindknopen door één tekstknoop; een lege tekenreeks verwijdert ze. Wil je de bestaande kindknopen behouden, voeg dan tekst aan het einde toe met append(text) of kies met insertAdjacentText(position, text) een positie ten opzichte van het element. Geen van deze tekstbewerkingen interpreteert opmaak of tekenverwijzingen in de tekenreeks.
Geef geen onbetrouwbare tekenreeksen door aan innerHTML: dit is een HTML-injectiepunt dat tot DOM-XSS kan leiden. Zo ingevoegde script-elementen worden niet uitgevoerd, maar via andere mechanismen, zoals attributen voor gebeurtenisafhandeling, kan nog steeds code worden uitgevoerd. Toon onbetrouwbare tekst in een gewoon element zoals div. Invoegen als tekst maakt dezelfde gegevens niet veilig in een script-, stijl- of URL-context, of als je ze later als HTML parset.
Heb je opgemaakte HTML uit een onbetrouwbare bron nodig, gebruik dan setHTML() waar het wordt ondersteund, of haal de HTML vóór invoeging door een beproefde sanitizer. Val nooit terug op een ongefilterde toewijzing aan innerHTML. Als CSP Trusted Types afdwingt en er geen standaardbeleid is, veroorzaakt toewijzing van een gewone tekenreeks aan innerHTML een TypeError. TrustedHTML garandeert geen opschoning: de veiligheid hangt af van het beleid dat dit object aanmaakte. Het zijn API’s van het webplatform, geen ECMAScript-functies. Controleer of de gebruikte beveiligingsmaatregelen worden ondersteund.
Voorbeelden
<!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>Resultaat
innerHTML: 1 | A & B textContent: 0 | <em>A & B</em>
Sla het voorbeeld op als HTML-bestand, open het in een browser zonder handhaving van Trusted Types en bekijk de uitvoer in de browserconsole. De vaste tekenreeks is onschadelijk: bij het parsen ontstaat één `em`-element en wordt de tekenverwijzing `&`. Bij invoeging als tekst blijft de hele tekenreeks behouden en ontstaat geen kindelement.
Gerelateerde lessen
- JavaScript · Les 15 · Gevorderd · Versie: 4