环境要求

本文档介绍了使用本框架所需的环境要求,包括 Node.js 环境和浏览器兼容性。

Node.js 环境

框架要求 Node.js 版本 >= 22.6,主要用于支持 TypeScript 类型导入(通过 --experimental-strip-types 标志),无需额外编译步骤。

浏览器兼容性

框架默认采用兼容模式构建,以支持更广泛的浏览器。但需要注意,要实现完整的浏览器兼容支持,需要手动添加 es-module-shims 依赖。

兼容模式(默认)

  • 🌐 Chrome:>= 87
  • 🔷 Edge:>= 88
  • 🦊 Firefox:>= 78
  • 🧭 Safari:>= 14

根据 Can I Use 的统计数据,兼容模式下的浏览器覆盖率达到 96.81%。

原生支持模式

  • 🌐 Chrome:>= 89
  • 🔷 Edge:>= 89
  • 🦊 Firefox:>= 108
  • 🧭 Safari:>= 16.4

原生支持模式具有以下优势:

  • 零运行时开销,无需额外的模块加载器
  • 浏览器原生解析,更快的执行速度
  • 更好的代码分割和按需加载能力

根据 Can I Use 的统计数据,兼容模式下的浏览器覆盖率达到 93.5%。

启用兼容支持

重要提示

虽然框架默认使用兼容模式构建,但要实现对旧版浏览器的完整支持,您需要在项目中添加 es-module-shims 依赖。

在 HTML 文件中添加以下脚本:

1<!-- 开发环境 -->
2<script async src="https://ga.jspm.io/npm:[email protected]/dist/es-module-shims.js"></script>
3
4<!-- 生产环境 -->
5<script async src="/path/to/es-module-shims.js"></script>
最佳实践
  1. 生产环境建议:
    • 将 es-module-shims 部署到自有服务器
    • 确保资源加载的稳定性和访问速度
    • 避免潜在的安全风险
  2. 性能考虑:
    • 兼容模式会带来少量性能开销
    • 可以根据目标用户群的浏览器分布决定是否启用