Tampermonkey中GM_setClipboard实现富文本复制的技术解析

在用户脚本开发中，复制内容到剪贴板是一个常见需求。Tampermonkey提供的GM_setClipboard API近期引发了关于富文本复制功能的讨论，本文将深入分析其实现原理和最佳实践。

一、基础文本复制功能

GM_setClipboard默认支持纯文本复制，这是最常见的用法：

GM_setClipboard("普通文本内容");

这种方式会将内容以纯文本格式(text/plain)存入剪贴板，适用于大多数简单场景。

二、富文本复制需求

现代办公场景中，用户常常需要保留文本格式（如粗体、斜体、颜色等）的复制能力。特别是在以下场景：

1. 从网页复制格式化内容到Word文档
2. 保留列表项的项目符号
3. 保持文本颜色和背景样式

三、HTML格式复制方案

Tampermonkey提供了通过HTML格式实现富文本复制的方案：

GM_setClipboard("<b>加粗文本</b>", {type: "html"});

这种方式的实现原理是：

1. 将内容以HTML格式(text/html)存入剪贴板
2. 富文本编辑器(如Word)会识别并解析HTML标签
3. 保留所有HTML支持的样式和结构

四、混合格式复制的最佳实践

为了同时兼容富文本编辑器和普通文本框，推荐使用混合格式复制方案。虽然GM_setClipboard目前不直接支持，但可以通过原生API实现：

const element = document.querySelector("#content");
navigator.clipboard.write([
  new ClipboardItem({
    "text/plain": new Blob([element.innerText], {type: "text/plain"}),
    "text/html": new Blob([element.innerHTML], {type: "text/html"})
  })
]);

这种方案的优点是：

1. 富文本编辑器会优先使用HTML格式
2. 普通文本框会回退到纯文本格式
3. 提供最佳的用户体验兼容性

五、实现注意事项

1. 权限要求：混合方案需要clipboard-write权限
2. 兼容性：部分旧浏览器可能不支持Clipboard API
3. 性能考量：大段HTML内容可能影响性能
4. 安全风险：直接复制innerHTML需注意XSS防护

六、未来改进方向

虽然当前GM_setClipboard的HTML类型已能满足基本需求，但可以考虑：

1. 增加自动混合格式支持
2. 提供更丰富的格式选项(RTF等)
3. 优化大内容复制的性能

通过合理使用这些技术方案，用户脚本开发者可以实现媲美原生体验的剪贴板功能，满足各类复杂场景的需求。