大网数据广告活动
Web 标准与前端开发

TrustedHTML

· 52CE 我爱测

Trusted Types API 的 **`TrustedHTML`** 接口表示一个可以被开发者插入到注入汇聚点中、渲染为 HTML 的字符串。这些对象通过 TrustedTypePolicy.createHTML() 创建,因此没有构造函数。

Trusted Types API

Trusted Types API 的 TrustedHTML 接口表示一个可以被开发者插入到注入汇聚点中、渲染为 HTML 的字符串。这些对象通过 TrustedTypePolicy.createHTML() 创建,因此没有构造函数。

TrustedHTML 对象的值在其创建时设置且不允许被 JavaScript 修改,因为其没有暴露 setter 方法。

实例方法

  • TrustedHTML.toJSON()
    • : 返回一个表示 TrustedHTML 对象的字符串,实际上与 TrustedHTML.toString() 的返回内容相同。此方法会由 JSON.stringify() 自动调用。
  • TrustedHTML.toString()
    • : 包含净化过的 HTML 的字符串。

示例

在下面的例子中,我们使用 TrustedTypePolicyFactory.createPolicy() 创建了一个策略,用于创建 TrustedHTML 对象。然后,我们可以使用 TrustedTypePolicy.createHTML() 来创建将要被插入文档的经过净化的 HTML 字符串。

净化过的值可以与 Element.innerHTML 配合使用来确保没有新的 HTML 元素可以被注入。

<div id="myDiv"></div>
const escapeHTMLPolicy = trustedTypes.createPolicy("myEscapePolicy", {
  createHTML: (string) => string.replace(/</g, "&lt;"),
});

let el = document.getElementById("myDiv");
const escaped = escapeHTMLPolicy.createHTML("<img src=x onerror=alert(1)>");
console.log(escaped instanceof TrustedHTML); // true
el.innerHTML = escaped;

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。