CKTIS / JavaScript
HTML-tekst escapen of de HTML-structuur opschonen met een toestemmingslijst
Door tekens te escapen toon je de invoer als letterlijke tekst. Structurele opschoning behoudt geselecteerde opmaak op basis van een lijst met toegestane elementen en attributen.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.textContent = input;
element.setHTML(input, { sanitizer: { elements: ["strong"], attributes: [], comments: false, dataAttributes: false } });Voeg je onbetrouwbare invoer in een gewoon tekstgedeelte van de HTML-broncode in, codeer die dan voor die context: vervang bijvoorbeeld & door & en < door <. De parser leest die verwijzingen als teksttekens, niet als tagsyntaxis. Werk je direct met het DOM, wijs dan de onbewerkte waarde toe aan textContent van een element zoals div: de inhoud wordt vervangen door tekst zonder HTML te parsen. HTML-tekst escapen biedt geen algemene bescherming voor attributen, URL’s, JavaScript of CSS.
Wil je opmaak behouden, schoon dan de structuur op. setHTML() parset het fragment in de context van het doelelement, past de lijst met toegestane elementen en attributen toe en verwijdert constructies die XSS mogelijk maken, zelfs als de configuratie ze toestaat. Het voorbeeld staat strong toe, maar geen attributen. Filter de geparste structuur in plaats van tags met een reguliere expressie te verwijderen. Als je beleid links toestaat, bepaal dan apart welke URL’s je toepassing accepteert.
textContent en setHTML() zijn API’s van het webplatform, geen functies van ECMAScript 2024. Controleer of je doelbrowsers setHTML() ondersteunen. Zo niet, gebruik platte tekst of een beproefde HTML-sanitizer; geef geen onbewerkte invoer door aan innerHTML. Neem ook niet aan dat het geserialiseerde resultaat veilig opnieuw kan worden geparset in een andere context: schoon het op bij invoeging in het doelelement.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>HTML text escaping and structural sanitization</title>
</head>
<body>
<pre id="output"></pre>
<script>
const input = '<strong title="label">A & B</strong><br>';
const text = document.createElement('div');
const rich = document.createElement('div');
if (typeof rich.setHTML !== 'function') {
throw new Error('This example requires a browser that supports Element.setHTML().');
}
text.textContent = input;
rich.setHTML(input, {
sanitizer: {
elements: ['strong'],
attributes: [],
comments: false,
dataAttributes: false,
},
});
document.getElementById('output').textContent =
[text.innerHTML, rich.innerHTML].join('\n');
</script>
</body>
</html>Resultaat
<strong title="label">A &amp; B</strong><br> <strong>A & B</strong>
De eerste regel serialiseert letterlijke tekst: zelfs de notatie `&` uit de invoer blijft als tekst behouden. De tweede toont een echt `strong`-element, zonder `title`-attribuut en zonder `br`-element. Het voorbeeld leest `innerHTML` alleen uit.
Gerelateerde lessen
- JavaScript · Les 16 · Gevorderd · Versie: 4