Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Kodiranje posebnih znakova u HTML tekstu i strukturna sanitizacija prema popisu dopuštenih stavki

Kodiranje znakova prikazuje unos kao doslovan tekst. Strukturna sanitizacija zadržava odabrano oblikovanje prema popisu dopuštenih elemenata i atributa.

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

Sintaksa

element.textContent = input;
element.setHTML(input, { sanitizer: { elements: ["strong"], attributes: [], comments: false, dataAttributes: false } });

Kad nepouzdan unos umećeš u obični tekst u izvornom HTML kodu, kodiraj ga za taj kontekst: na primjer, zamijeni & s &amp;, a < s &lt;. Parser te reference čita kao tekstualne znakove, a ne kao sintaksu oznaka. Ako radiš izravno s DOM-om, dodijeli izvornu vrijednost svojstvu textContent elementa poput div: sadržaj se zamjenjuje tekstom bez parsiranja HTML-a. Kodiranje HTML teksta nije opća zaštita za atribute, URL-ove, JavaScript ili CSS.

Ako želiš zadržati oblikovanje, sanitiziraj strukturu. setHTML() parsira fragment u kontekstu odredišnog elementa, primjenjuje popis dopuštenih elemenata i atributa te uklanja konstrukcije koje predstavljaju rizik od XSS-a čak i ako ih konfiguracija dopušta. Pravila u primjeru dopuštaju strong, ali nijedan atribut. Filtriraj parsiranu strukturu umjesto uklanjanja oznaka regularnim izrazom. Ako pravila dopuštaju poveznice, zasebno odredi koje URL-ove aplikacija prihvaća.

textContent i setHTML() su sučelja web-platforme, a ne značajke ECMAScripta 2024. Provjeri podržavaju li ciljni preglednici setHTML(). Ako nije dostupan, koristi običan tekst ili provjereni alat za sanitizaciju HTML-a; ne prosljeđuj neobrađeni unos u innerHTML. Nemoj pretpostaviti ni da je serijalizirani rezultat sigurno ponovno parsirati u drugom kontekstu: sanitiziraj ga pri umetanju u odredišni element.

Primjeri

<!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 &amp; 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>

Rezultat

&lt;strong title="label"&gt;A &amp;amp; B&lt;/strong&gt;&lt;br&gt;
<strong>A &amp; B</strong>

Prvi redak serijalizira doslovan tekst: čak je i zapis `&amp;` iz unosa sačuvan kao tekst. Drugi prikazuje stvarni element `strong` bez atributa `title` i bez elementa `br`. Primjer samo čita `innerHTML`.

Povezane lekcije

  • JavaScript · Lekcija 16 · Napredno · Verzija: 4

Izvori