Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Kodowanie tekstu HTML a strukturalna sanityzacja według listy dozwolonych elementów i atrybutów

Kodowanie znaków pozwala wyświetlić dane dosłownie jako tekst. Sanityzacja strukturalna pozwala zachować wybrane formatowanie, filtrując elementy i atrybuty zgodnie z ustaloną polityką.

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

Składnia

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

Gdy wstawiasz niezaufaną wartość do zwykłego tekstu w źródle HTML, zakoduj ją dla tego kontekstu: na przykład zamień & na &amp;, a < na &lt;. Parser odczyta te odwołania jako znaki tekstowe, a nie jako składnię znaczników. Jeśli pracujesz bezpośrednio z DOM, przypisz niezakodowaną wartość do textContent elementu takiego jak div: przypisanie zastępuje jego zawartość tekstem bez parsowania HTML. Kodowanie tekstu HTML nie jest uniwersalną ochroną dla atrybutów, adresów URL, JavaScriptu ani CSS.

Gdy użytkownik ma zachować formatowanie, zastosuj strukturalną sanityzację. setHTML() parsuje fragment w kontekście elementu docelowego, egzekwuje listę dozwolonych elementów i atrybutów oraz usuwa konstrukcje niebezpieczne z punktu widzenia XSS, nawet jeśli konfiguracja je dopuszcza. Polityka z przykładu dopuszcza element strong, ale nie dopuszcza atrybutów. Filtruj rozpoznaną strukturę zamiast usuwać znaczniki wyrażeniem regularnym. Jeśli polityka dopuszcza linki, osobno ustal, które adresy URL są akceptowalne w aplikacji.

textContent i setHTML() to interfejsy platformy webowej, nie funkcje ECMAScriptu 2024. Sprawdź obsługę setHTML() w docelowych przeglądarkach. Jeśli go brakuje, wybierz zwykły tekst lub sprawdzony sanitizer HTML; nie podstawiaj surowych danych do innerHTML. Nie traktuj też zserializowanego wyniku jako bezpiecznego do ponownego parsowania w innym kontekście: sanityzuj przy wstawianiu do docelowego elementu.

Przykłady

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

Wynik

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

Pierwszy wiersz to serializacja dosłownego tekstu: nawet zapis `&amp;` z wejścia został zachowany jako tekst. Drugi pokazuje rzeczywisty element `strong` bez atrybutu `title` i bez elementu `br`. `innerHTML` służy tu wyłącznie do odczytu.

Powiązane lekcje

  • JavaScript · Lekcja 16 · Zaawansowany · Wersja: 4

Źródła