截至 API 版本 2026-04，Shopify 提供了用于 UI 扩展的官方测试库。 @shopify/ui-extensions-tester @shopify/ui-extensions-tester 允许您在任何界面（Checkout、Admin、Customer Accounts 和 POS）上为扩展编写单元测试，而无需运行 Shopify 主机。
功能概述
该库提供具有强类型定义的扩展 API 模拟对象，因此您可以隔离渲染扩展、模拟用户交互，并通过完整的类型安全性针对公共 API 验证行为。
核心能力
- 渲染与查询: 在标准 DOM 环境中渲染您的扩展，并使用标准测试模式查询输出结果。
- 类型安全的模拟: 模拟的 shopify shopify 全局对象使用与真实 API 相同的类型，从而在测试时捕获不正确的 API 用法。
- 面向特定界面的默认值: 为每个目标界面（Checkout、Admin、Customer Accounts、POS）提供合理的模拟默认值，使测试开箱即用。
- 事件模拟: 触发用户交互，并通过 dispatch Event() 或 @testing-library/preact 测试异步状态变更。 dispatchEvent() 或 @testing-library/preact.
- 对 AI 代理友好：强类型模拟和可预测的测试模式使该库非常适合用于 AI 辅助的测试驱动开发。
入门指南
阅读 文档 以了解更多。 开始使用针对每个表面的示例测试套件。 示例测试 套件 适用于各种场景。