База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Екраниране на HTML текст и структурно пречистване по списък с разрешени елементи и атрибути

Екранирането на знаци показва входа като буквален текст. Структурното пречистване запазва избрано форматиране според списък с разрешени елементи и атрибути.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

Когато вмъкваш ненадеждни данни в обикновен текст в изходния HTML код, кодирай ги за този контекст: например замени & с &amp;, а < с &lt;. Анализаторът прочита тези препратки като текстови знаци, а не като синтаксис на тагове. Ако работиш директно с DOM, присвои необработената стойност на textContent на елемент като div: съдържанието му се заменя с текст, без да се анализира като HTML. Екранирането на HTML текст не е обща защита за атрибути, URL адреси, JavaScript или CSS.

Ако искаш да запазиш форматирането, пречисти структурата. setHTML() анализира фрагмента в контекста на целевия елемент, налага списъка с разрешени елементи и атрибути и премахва конструкции, които създават риск от XSS, дори конфигурацията да ги разрешава. Политиката в примера разрешава strong, но не и атрибути. Филтрирай анализираната структура, вместо да премахваш тагове с регулярен израз. Ако политиката разрешава връзки, определи отделно кои URL адреси приема приложението.

textContent и setHTML() са интерфейси на уеб платформата, а не функции на ECMAScript 2024. Провери дали целевите браузъри поддържат setHTML(). Ако не го поддържат, използвай обикновен текст или проверен инструмент за пречистване на HTML; не подавай необработени данни към innerHTML. Не приемай, че сериализираният резултат може безопасно да се анализира отново в друг контекст: пречисти го при вмъкване в целевия елемент.

Примери

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

Резултат

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

Първият ред сериализира буквален текст: дори записът `&amp;` от входа се запазва като текст. Вторият показва действителен елемент `strong` без атрибут `title` и без елемент `br`. Примерът само чете `innerHTML`.

Свързани уроци

  • JavaScript · Урок 16 · Напреднало · Версия: 4

Източници