Fabric.js Document Engine

搜索文档

查找页面或章节

EN

测试过的浏览器、Fabric.js 版本和实测性能。

每次发布前,都会跑同一套浏览器测试。下面是 1.x 版本的 Fabric.js 兼容性和性能情况。

支持的环境

1.x 支持
Fabric.js6.x 和 7.x
浏览器当前版本的 Chromium、Firefox 和 WebKit(Safari),每次发布都测试
React18 和 19,通过 fabricjs-document-engine/react
Node.jsFabric.js 6 需要 18+,Fabric.js 7 需要 20+。导入、校验、迁移、安全检查和存储适配器都能用;画布相关功能需要浏览器
PDF可选的 jspdf 4 和 svg2pdf.js 2.7 或更高,用于浏览器中的 fabricjs-document-engine/pdf
滤镜fabricjs-document-engine/filters 使用模块 Worker 和 OffscreenCanvas(Chrome 80、Firefox 114、Safari 16.4);较旧的浏览器在主线程上分步运行滤镜
滤镜fabricjs-document-engine/filters 使用模块 Worker 和 OffscreenCanvas:Chrome 80、Firefox 114、Safari 16.4 及以上版本。其他环境中滤镜在主线程分步运行
文字ShapedIText 和 ShapedTextbox 使用浏览器自己的排版来测量,结果取决于安装的字体

测试结果

ChromiumFirefoxWebKit(Safari 引擎)Node
Fabric.js 7.4全部通过全部通过全部通过导入、校验和迁移通过
Fabric.js 6.9全部通过未单独运行未单独运行导入、校验和迁移通过
  • 浏览器测试覆盖 id、保存和加载、历史记录、安全保存、资源和字体、基于 IndexedDB 的恢复、导出、版本、迁移、React、取消、自定义对象和安全限制。
  • Fabric.js 6 和 Fabric.js 7 的默认原点不同。文档总是保存 originX 和 originY,所以用一个版本保存的文件,在另一个版本里也能正确打开。
  • WebKit 无法在 IndexedDB 中存储 Blob。恢复副本把图片数据存为字节,所以在 Safari 里恢复也能用。

性能

使用 5,000 个对象测量(60% 矩形、20% 圆形、10% 文本框、10% 编组),列出最慢浏览器的结果。

步骤目标最慢实测
移动后记录一步撤销50 ms27 ms
用事务修改一个对象的样式50 ms29 ms
撤销一步50 ms28 ms
保存到内存存储50 ms29 ms
加载一份文档1,000 ms828 ms
导出前的检查50 ms22 ms

导出耗时几乎全部来自 Fabric.js 自身的渲染和浏览器的图片编码。每个浏览器都会跑一个 2,000 对象的回归测试,性能明显下降时构建就会失败。

内存

  • 默认情况下,撤销最多保留 100 步、64 MB 对象数据。每一步只存改动过的对象。
  • 每份文档只保留一份恢复副本,保存覆盖所有改动后即删除。
  • 导入的文档最多 50,000 个对象、嵌套 100 层。
  • 加载时每次创建 100 个对象,同时检查六张图片,每张最多等 30 秒。
  • renderDocuments 默认保留两个离屏画布,每份文档完成后释放它的对象和缓存画布。

引擎绕开的 Fabric.js 问题

每个问题都在 Fabric.js 6.9 和 7.4 上复现过,并有测试保护对应的处理。

Fabric.js 的问题Issue引擎的处理
没有 PDF 导出#5906PDF 导出
SVG 里的曲线文字忽略 pathAlign,装饰线画成直的#6958SVG 导出
SVG 导出通过 URL 链接图片#1980svg.embedImages
viewBox 外有元素时,导入的 SVG 会移位#10916SVG 导入
大文档加载时页面卡住#9632分批加载,并报告进度
图片加载失败时没有原因#11074每张缺失图片都有 failure.reason
克隆的编组和选区落在错误的位置#2974createClipboard
浏览器中 dispose() 不会释放画布内存#4848renderDocuments 自己释放画布
长单词让 Textbox 超出设定宽度#2376BoundedTextbox
没有竖排文字#511VerticalText
阿拉伯文和连字的光标会偏移#4815ShapedIText
Android 键盘把文字和样式放错位置#6588attachMobileTextInput
用代码修改文字后样式留在旧字母上#6133createTextCommands
导入的 SVG 丢失编组#899preserveGroups
图片滤镜让页面卡住#9532Worker 中的滤镜
每一帧都重绘所有对象#9847脏区域渲染

各浏览器的完整数据见 GitHub 上的兼容性结果。1.x 的 Fabric.js 兼容性承诺总结在版本发布页面。

Fabric.js 兼容性 | Fabric.js Document Engine