Trusted Types
为什么重要 CSP 拦截的是被注入的脚本标签。但许多现代的漏洞藏在你自己的 JavaScript 里:像 box.innerHTML = comment 这样的一行,会把来自访客的文本变成活的 HTML。这就是第 10 模块讲的基于 DOM 的注入(第 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 年 10 月核实)。使用较老浏览器的访客只是得不到这项额外的检查,所以要保留转义,也要保留你基于 nonce 的 CSP。代码可以用 if (window.trustedTypes) 来检测它。
像任何策略一样上线它:先在一个 Content-Security-Policy-Report-Only 响应头里发送 require-trusted-types-for 'script'。每一个到达汇点的字符串都会被报告出来,准确地告诉你哪些代码行需要一个策略,或者更好的是,改用 textContent。
一个常见的误解:“Trusted Types 会替我清理 HTML”。它不会清理任何东西。它强制字符串经过你的策略。一个原样返回输入的策略(createHTML: s => s)能通过检查,却保护不了任何东西。
回顾
- DOM 注入发生在你自己的 JavaScript 里,在像
innerHTML这样的汇点上;仅靠脚本标签的规则抓不住它。 require-trusted-types-for 'script'让汇点拒绝普通字符串;trusted-types NAME限制可以存在哪些策略。- 审查那几个策略函数,而不是每一个汇点,并在可以的地方优先使用
textContent。 - 在所有主流引擎中都得到了支持(2026 年 10 月核实);先在仅报告模式下上线。
这个练习即将开放
完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。
这个浏览器屏蔽了 learn.floati.life 的 Cookie,所以你在这里完成的课程无法按顺序打开。请允许这个网站使用 Cookie,然后重新加载。