Создание сайтов · IT-курсы · 4 мин чтения

Почему пользовательский текст лучше вставлять через textContent?

Редакция Алгоса · Обновлено

Короткий ответ

textContent вставляет строку как текст. innerHTML разбирает строку как HTML и создаёт из неё элементы. Если нужно показать комментарий или имя, обычно подходит textContent: знаки угловых скобок остаются символами. Вставка непроверенного ввода через innerHTML может позволить чужой строке изменить страницу и выполнить опасное поведение.

Как это устроено

Браузер различает текст для чтения и разметку, описывающую элементы. Строка «<b>Привет</b>» может быть либо буквальной записью с тегами, либо командой создать жирный текст. Разницу задаёт выбранный способ вставки, а не происхождение строки. Даже ответ сервера не становится безопасной разметкой только потому, что пришёл по сети.

Сравни действия и их результат
СпособКак воспринимается строка
textContentКак буквальный текст
innerHTMLКак HTML-разметка
createElementКак явно созданный элемент

Разберём на примере

Сделаем предварительный просмотр подписи. Пользователь вводит текст в поле, а рядом появляется результат. Для обычной подписи не нужны ссылки, изображения и HTML-теги. Поэтому самым понятным поведением будет буквальное отображение введённого текста. Дополнительную разметку интерфейса можно создавать отдельно средствами DOM — дерева элементов страницы.

Пример по шагам

Пусть input — поле ввода, preview — элемент результата. Строка preview.textContent = input.value покажет всё введённое буквально. Если в поле написать <b>Кот</b>, на экране появится именно эта запись со скобками; жирный элемент из неё не создаётся.

Почему так

innerHTML нужен только там, где действительно требуется разобрать разметку и обеспечена её безопасная подготовка. Простая замена одного подозрительного слова не защищает HTML: способов создать нежелательное поведение много. textContent решает более узкую задачу показа текста и не является универсальной защитой для адресов ссылок или других опасных мест.

Проверь себя

Пользователь написал «2 < 3 и 5 > 4». Нужно ли удалять знаки сравнения перед выводом через textContent? А если редактор должен разрешать жирный текст? Сначала определи требуемый формат. Не добавляй поддержку произвольного HTML только потому, что так короче написать одну строку кода.

Ответ и объяснение

Для textContent удалять знаки не требуется: они показываются буквально. Для форматированного редактора нужен отдельный ограниченный формат и проверенная обработка допустимой разметки. Учти также, что присваивание textContent заменяет дочернее содержимое элемента: выбирай отдельное место для текста, чтобы не удалить расположенные внутри кнопки.

Что запомнить

Для обычного пользовательского текста выбирай textContent; поддержку разметки проектируй отдельно.

Попробовать на Алгосе

Создание сайтов

Курс помогает освоить HTML/CSS и первые обработчики событий JavaScript. Отправка на настоящий сервер выходит за рамки этого примера.

Перейти к курсу Все курсы

Источники и материалы

Разобраться дальше

Все вопросы и разборы