Trusted Types
Почему это важно CSP блокирует внедрённые теги script. Но многие современные ошибки живут внутри вашего собственного JavaScript: строка вроде box.innerHTML = comment превращает текст посетителя в живой HTML. Это внедрение на основе DOM из модуля 10 (урок 59), и оно происходит после загрузки страницы. Trusted Types заставляет браузер отказываться от этих опасных строк, если значение не прошло написанную вами проверку.
Представьте завод, где на сборочную линию могут попасть только детали со штампом контроля. Никто не может прикрутить случайную деталь, найденную на парковке, даже по ошибке. Trusted Types добавляет такой штамп к строкам, которые ваш код отправляет в опасные места.
DOM: сокращение от Document Object Model, живое дерево элементов, которое браузер строит из страницы и которое JavaScript может читать и менять.
Приёмник (sink): место в DOM, где строка становится кодом или разметкой. Примеры: element.innerHTML, outerHTML, insertAdjacentHTML, document.write, iframe.srcdoc, eval и строковые аргументы setTimeout, а также script.src.
Trusted Types: функция браузера, включаемая через CSP, при которой эти приёмники принимают только особые объекты (TrustedHTML, TrustedScript, TrustedScriptURL), созданные политикой - небольшой функцией, которую вы пишете и называете. Обычная строка, присвоенная приёмнику, вызывает ошибку вместо выполнения.
Включение
Content-Security-Policy: require-trusted-types-for 'script'; trusted-types commentsrequire-trusted-types-for 'script': применять ко всем приёмникам, связанным со скриптами.trusted-types comments: единственное имя политики, которое может создать ваш код. Внедрённый скрипт не может зарегистрировать собственную политику под другим именем.trusted-types 'none'запрещает создавать любые.
Использование в вашем коде
// The one, reviewed place that turns text into HTML.
const commentsPolicy = trustedTypes.createPolicy("comments", {
createHTML: (text) => escapeHtml(text), // or a well-tested sanitiser
});
box.innerHTML = comment; // throws TypeError: blocked
box.innerHTML = commentsPolicy.createHTML(comment); // allowed, escaped
box.textContent = comment; // not a sink at all: always fineБольшой выигрыш - для ревьюеров. Вместо того чтобы выискивать каждый innerHTML в большой кодовой базе, вы проверяете несколько функций-политик. Если они безопасны, браузер следит, чтобы всё остальное шло через них.
Политика с именем default особая: браузер вызывает её автоматически, когда обычная строка доходит до приёмника. Это полезно при переводе старого кода, но в ней же прячутся ошибки, поэтому держите её строгой и записывайте в лог то, что через неё проходит.
Поддержка и внедрение
Trusted Types поддерживается во всех крупных движках: браузерах на основе Chromium, Safari 26 и Firefox 148 (проверено в октябре 2026). Посетители в старых браузерах просто не получают дополнительной проверки, поэтому сохраняйте экранирование и свою CSP на основе nonce. Код может проверить поддержку через if (window.trustedTypes).
Внедряйте как любую политику: сначала отправьте require-trusted-types-for 'script' в заголовке Content-Security-Policy-Report-Only. О каждой строке, дошедшей до приёмника, будет сообщено, и вы увидите ровно те строки, которым нужна политика или, лучше, переход на textContent.
Распространённое заблуждение: "Trusted Types очищает HTML за меня". Он ничего не очищает. Он заставляет строки проходить через вашу политику. Политика, которая возвращает вход без изменений (createHTML: s => s), проходит проверку и ничего не защищает.
Итоги
- Внедрение в DOM происходит в вашем собственном JavaScript в приёмниках вроде
innerHTML; одни правила для тегов script его не ловят. require-trusted-types-for 'script'заставляет приёмники отказываться от обычных строк;trusted-types NAMEограничивает, какие политики могут существовать.- Проверяйте несколько функций-политик вместо каждого приёмника и по возможности предпочитайте
textContent. - Поддерживается во всех крупных движках (проверено в октябре 2026); сначала внедряйте в report-only.
Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке
Это упражнение откроется скоро
Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.
Этот браузер блокирует cookies для learn.floati.life, поэтому завершенные здесь уроки не могут открыться по порядку. Разрешите cookies для этого сайта и перезагрузите страницу.