Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Ubežno kodiranje besedila HTML in strukturno čiščenje po seznamu dovoljenih elementov in atributov

Ubežno kodiranje znakov prikaže vnos kot dobesedno besedilo. Strukturno čiščenje ohrani izbrano oblikovanje na podlagi seznama dovoljenih elementov in atributov.

Različica: 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 } });

Ko nezaupanja vreden vnos vstaviš na mesto navadnega besedila v izvorni kodi HTML, ga kodiraj za ta kontekst: na primer zamenjaj & z &amp; in < z &lt;. Razčlenjevalnik te sklice prebere kot besedilne znake, ne kot skladnjo oznak. Če delaš neposredno z DOM-om, dodeli izvorno vrednost lastnosti textContent elementa, kot je div: vsebina se nadomesti z besedilom brez razčlenjevanja HTML-ja. Ubežno kodiranje besedila HTML ni splošna zaščita za atribute, URL-je, JavaScript ali CSS.

Če želiš ohraniti oblikovanje, očisti strukturo. setHTML() razčleni fragment v kontekstu ciljnega elementa, uporabi seznam dovoljenih elementov in atributov ter odstrani konstrukte, ki pomenijo tveganje za XSS, tudi če jih konfiguracija dovoljuje. Pravila v primeru dovoljujejo strong, ne pa atributov. Filtriraj razčlenjeno strukturo, namesto da oznake odstranjuješ z regularnim izrazom. Če pravila dovoljujejo povezave, posebej določi, katere URL-je sprejema aplikacija.

textContent in setHTML() sta vmesnika spletne platforme, ne funkciji ECMAScripta 2024. Preveri podporo za setHTML() v ciljnih brskalnikih. Če je ni, uporabi golo besedilo ali preverjeno orodje za čiščenje HTML-ja; ne posreduj neobdelanega vnosa v innerHTML. Tudi pri serializiranem rezultatu ne predpostavljaj, da ga je varno znova razčleniti v drugem kontekstu: očisti ga ob vstavljanju v ciljni element.

Primeri

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

Prva vrstica serializira dobesedno besedilo: celo zapis `&amp;` iz vnosa ostane besedilo. Druga prikazuje pravi element `strong` brez atributa `title` in brez elementa `br`. Primer `innerHTML` samo bere.

Povezane lekcije

  • JavaScript · Lekcija 16 · Napredna · Različica: 4

Viri