HTML Entities — кодирование и декодирование HTML-сущностей

Что делает HTML Entities

HTML Entities кодирует символы, имеющие особое значение в HTML, и декодирует ссылки на сущности обратно в читаемый текст. Он полезен, когда вы готовите примеры для документации, пишете тестовые фикстуры для логики экранирования, проверяете вывод CMS, очищаете скопированные фрагменты или преобразуете видимый текст в форму, которая может безопасно находиться в исходном коде HTML. Кодировщик обрабатывает амперсанды, угловые скобки, кавычки, апострофы и символы вне ASCII, используя числовые сущности там, где это уместно. Декодировщик поддерживает именованные сущности, распознаваемые браузером, такие как amp, lt, gt, quot, apos, copy, nbsp и многие другие, с помощью собственного HTML-парсера браузера.

Реальные фрагменты кода часто смешивают именованные сущности с десятичными или шестнадцатеричными числовыми ссылками, созданными шаблонами, редакторами, лентами и устаревшими системами. Этот инструмент упрощает переход между видимым текстом и исходной формой без написания одноразового скрипта. Кнопка обмена позволяет передать результат в противоположный режим, чтобы проверить преобразование в обе стороны.

Приватная работа в браузере

Вся обработка выполняется в вашем браузере с помощью клиентского JavaScript. Инструмент не загружает на сервер фрагменты, значения конфигураций, сгенерированные данные, тексты запросов или скопированные примеры и не требует учётной записи. Такая исключительно локальная модель важна для инструментов разработчика, потому что вставляемое в них содержимое часто похоже на реальные данные приложений: ответы API, логи, примеры в виде переменных окружения, запросы к базам данных, разметка из черновиков или значения, скопированные во время отладки на продакшене. Локальное преобразование снижает риск и сохраняет высокую скорость работы, ведь сетевых обращений нет.

Интерфейс намеренно компактен, чтобы вы могли вставить входные данные, настроить параметры, просмотреть результат, скопировать его и вернуться в редактор. Результаты всё равно нужно проверять, прежде чем коммитить их, публиковать или использовать в производственном процессе. Браузерные инструменты отлично подходят для быстрого просмотра и подготовки, но не могут знать все соглашения проекта, правила классификации данных или требования проверки, специфичные для приложения.

Практические советы

Кодирование сущностей само по себе не является полноценным средством санитизации с точки зрения безопасности. Используйте его как преобразование текста для примеров, тестов и простых проверок экранирования, а не как замену экранирования во фреймворке, API DOM, политики безопасности содержимого или проверенного санитайзера при отображении недоверенного HTML. Контекст имеет значение: экранирование для текстового узла HTML отличается от экранирования для атрибутов, URL, строк JavaScript и CSS. При декодировании помните, что результат может снова содержать настоящие угловые скобки или кавычки, поэтому проверьте его, прежде чем вставлять на страницу или в шаблон.