Vision SDK抢先体验

您的 Playwright 测试,由 Delta-QA 校验。每个要校验的页面只需一行。

在 Playwright 测试中添加一行:Delta-QA 像人眼一样比较每个页面,并指出发生了什么变化。

抢先体验:联系我们,在您的测试中使用。

在测试中只需三步

  1. 创建 API 密钥:在 Delta-QA 工作区中创建,并存入 CI 的密钥变量。SDK 从 DELTAQA_API_KEY 读取;工作区即密钥所属的工作区。
  2. 添加一个 check:在测试需要校验页面的位置写 checkout.check("Payment")。它的名称在测试中唯一,用于将其与基准对应。
  3. 推送。首次运行时,每个测试都是“新建”:第一张截图成为基准。第二次运行时,如果网站未变,不会报告任何差异。
import { test } from "@delta-qa/vision/fixture";

test("Checkout", async ({ page, vision }) => {
  const checkout = await vision.open(page, { id: "checkout", name: "Checkout" });
  await page.goto("https://shop.example.com/checkout");
  await checkout.check("Payment");
}); // closed by the fixture: fails the test on a difference to judge

SDK 只提供 Delta-QA 实际应用的设置:不会接受任何无效设置。被测的分支、基础分支和提交都是可选的,SDK 从不自行推断:由您的测试提供。

从 Applitools Eyes 迁移?请看迁移指南

像人眼那样比较,而不是比较像素

对于每个 check,Delta-QA 都会像场景步骤一样,像人眼那样将页面与其基准比较:报告会告诉您哪个元素发生了变化,例如“Pay”按钮由蓝变绿,而不是一块像素区域。

待判定的差异会使 Playwright 测试失败,错误信息会给出它在 Delta-QA 中的链接。您打开该步骤,阅读报告并做出判断:“预期行为”或“Bug”。

从第二次运行起,您的运行依然快速。

每个分支一份基准,不自动合并

  • 分支由您的测试提供,连同其基础分支和提交:open(page, { branch, baseBranch, commit }),取自您 CI 的变量。SDK 既不读取 git,也不读取 CI。从 Applitools 迁移来的套件可保留 APPLITOOLS_BRANCH、APPLITOOLS_PARENT_BRANCH 和 APPLITOOLS_BATCH_ID。新分支从首次运行起就与其基础分支的基准比较。
  • “预期行为”作用于您勾选的分支,默认仅限“此分支”:其他分支不会看到任何变化。
  • 测试的历史可按环境和分支筛选;任何一次运行都可以设为基准,作用于您勾选的分支。
  • 在同一个提交上运行的测试组成一个版本,由提供同一提交、并行运行的多台机器共享;版本列表的呈现方式与您的 CI 一致。

GitHub Actions、GitLab CI、Bitbucket Pipelines 和 Azure Pipelines 中保存分支、基础分支和提交的变量:迁移指南

借助 AI 智能体创建场景:MCP 服务器

关于 Vision SDK 的问题

Vision SDK 支持哪些框架?
支持 TypeScript 和 JavaScript 的 Playwright,运行于 Chromium。Cypress、WebdriverIO、Firefox 和 WebKit 将陆续支持。您无需代码录制的场景在同一个 Delta-QA 工作区中校验。
需要重写我的 Playwright 测试吗?
不需要:只需在要校验页面的位置添加一个 check,测试的其余部分保持不变。check 的名称将其与基准对应:同一测试中出现两个同名 check 时,运行会失败并指出重复项。
SDK 会发送哪些数据?
您的测试所校验的页面及其使用的文件,视频和音频除外。这些数据仅用于比较,并保留在您的工作区中。请勿使用生产环境中的个人数据进行测试:这一选择由您决定。
我无需代码的场景会有变化吗?
不会:录制、回放和报告保持不变。场景同样可以在某个分支下运行,“预期行为”作用于您勾选的分支。
可以在其他语言中使用吗?
SDK 适用于 TypeScript 和 JavaScript。如果用户有需求,将增加其他语言。

让 Delta-QA 校验您的 Playwright 测试

如需使用 Vision,请联系我们:它首先以抢先体验方式提供。告诉我们您想校验哪些测试,我们会为您开通访问。