Tiptap编辑器中的Trusted Types安全策略问题解析

2025-05-05 04:29:41作者：裴麒琰

Tiptap作为一款基于ProseMirror的现代化富文本编辑器，在最新版本中遇到了一个与浏览器安全策略相关的兼容性问题。本文将深入分析该问题的技术背景、影响范围以及可能的解决方案。

问题背景

现代Web应用面临着各种安全威胁，其中跨站脚本攻击(XSS)是最常见的攻击方式之一。为了应对这一威胁，Chrome浏览器引入了Trusted Types API作为内容安全策略(CSP)的扩展机制。该API要求开发者显式声明动态HTML内容的可信来源，从而防止恶意脚本注入。

在Tiptap的核心代码中，elementFromString函数直接使用字符串创建DOM元素，这在启用了Trusted Types策略的环境中会触发安全异常。具体表现为浏览器抛出"This document requires 'TrustedHTML' assignment"错误，导致编辑器功能无法正常使用。

技术原理分析

Trusted Types的工作原理是通过创建安全策略来验证动态内容。开发者需要先定义一个内容安全策略，然后通过该策略创建可信的HTML、脚本或URL内容。这些经过验证的内容才能被浏览器API接受。

在Tiptap的实现中，elementFromString函数直接将字符串传递给DOMParser，而没有经过Trusted Types验证。这在严格的安全策略环境下会被浏览器阻止，因为可能存在XSS风险。

解决方案探讨

针对这一问题，社区提出了以下改进方案：

创建Trusted Types策略：在编辑器初始化时创建一个默认策略，该策略可以定义如何处理输入的HTML内容。
修改elementFromString实现：将原始字符串通过Trusted Types策略转换为可信HTML后，再传递给DOMParser进行解析。
兼容性处理：在非Chrome浏览器或不支持Trusted Types的环境中，保持原有实现以确保向后兼容。

实现建议

基于技术分析，建议的代码改进方向如下：

// 创建默认的Trusted Types策略
const defaultPolicy = window.trustedTypes?.createPolicy('tiptap-default', {
  createHTML: (input) => input,
  createScript: () => '',
  createScriptURL: () => ''
});

function elementFromString(value: string): HTMLElement {
  // 使用Trusted Types策略处理HTML
  const processedHTML = defaultPolicy 
    ? defaultPolicy.createHTML(`<body>${value}</body>`)
    : `<body>${value}</body>`;
  
  // 解析处理后的HTML
  const html = new DOMParser().parseFromString(
    processedHTML,
    'text/html'
  ).body;
  
  return removeWhitespaces(html);
}