通过 URL 分享结果

Compare HTML 可以将对比输入编码到 URL 查询参数中,让你无需通过服务器发送 HTML,就能与团队成员分享差异结果,或从文档中链接到某个对比。

URL 分享原理

所有分享都通过 /result 页面完成。该页面会读取 basecontrast 查询参数,解析后自动运行对比。

https://comparehtml.com/result?base=...&contrast=...

由于对比在浏览器中运行,分享的 URL 包含原始数据或指向数据的链接,而不是服务器端快照。

方法一:从文件 URL 加载 HTML

basecontrast 参数中传入可公开访问的 HTML 文件 URL。

https://comparehtml.com/result?base=https://comparehtml.com/example_data/demo.base.html&contrast=https://comparehtml.com/example_data/demo.contrast.html

结果页加载时会抓取两个 URL 并自动对比其中的 HTML 内容。这种方式 URL 更短,适合分享存储在版本控制或云存储中的文件对比。

方法二:从 Base64 加载 HTML

将每个 HTML 文档编码为 Base64 字符串,直接放入 URL。

<div>
  <p>基准 HTML 内容</p>
</div>
<div>
  <p>对照 HTML 内容</p>
</div>

编码后的 Base64 值可生成如下可分享 URL:

https://comparehtml.com/result?base=PGRpdj48cD5CYXNlIEhUTUwgY29udGVudDwvcD48L2Rpdj4=&contrast=PGRpdj48cD5Db250cmFzdCBIVE1MIGNvbnRlbnQ8L3A+PC9kaXY+

你可以使用 base-64.com 编码自己的 HTML。这种方式自包含,适用于任何可以 Base64 编码的 HTML。需要注意的是,非常大的 HTML 值会生成很长的 URL。

安全与隐私

  • 分享的 URL 包含 HTML 数据或指向数据的链接,请只分享给需要访问的人。
  • 远程 HTML 文件必须可公开访问,并配置适当的 CORS 响应头。
  • Compare HTML 不会在服务器上存储对比输入,URL 是唯一的数据传递方式。