VS Code、Cursor 和 Windsurf
本页由英文自动翻译。
阅读英文版适用于 VS Code 的 Proxy Mail QA 把测试地址放在你的代码旁边。在侧边栏创建一个地址,用它在你的应用中注册,邮件中的验证码或链接就会显示在侧边栏,可以直接复制。选择 等待验证码,验证码还会显示在状态栏。它还能插入用于注册、重置密码和魔法链接的 Playwright 和 Cypress 测试。
它在 Visual Studio Marketplace 上提供给 VS Code,在 Open VSX 上提供给 Cursor、Windsurf、Qoder 以及其他基于 VS Code 的编辑器。
在 VS Code 中打开“扩展”,搜索 Proxy Mail QA,然后选择 安装。在 Cursor、Windsurf 或 Qoder 中,同样的搜索会在 Open VSX 上找到它。
为项目创建一个 API 密钥。在活动栏中打开 Proxy Mail QA 视图,选择 添加 API 密钥 并粘贴密钥。
VS Code 把密钥保存在它的密钥存储中。侧边栏永远看不到密钥:它只获取地址和验证码,其余工作交给 VS Code。
创建测试地址
Section titled “创建测试地址”在 新地址 下,可以按需选择国家、年龄段和环境,以及是否生成密码。然后选择 新地址。
地址、测试人物的信息和密码都会显示出来,各带一个复制按钮。密码只在你选择 完成 之前显示,请先复制。
用该地址在你的应用中注册,然后选择 等待验证码。状态栏会显示“正在等待验证码…”,最长 2 分钟。邮件到达后,验证码显示在状态栏,并弹出通知提供 复制验证码。
| 部分 | 作用 |
|---|---|
| 项目 | 在你添加的项目之间切换 |
| 新建地址 | 按你选择的国家、年龄段和环境,创建带测试人物的测试地址 |
| 验证码和链接 | 你的有效地址,最新的在前,每个地址显示其邮件中最新的验证码、链接或优惠券 |
| 地址所在行 | 打开可查看测试人物的信息,每项都带复制按钮,还有 等待验证码 或 等待链接 |
| 链接 | 复制链接,或在浏览器中打开 |
每类邮件都保持与应用中相同的颜色:验证码、登录链接、重置链接、邀请和优惠券。侧边栏打开时,列表每 15 秒刷新一次。
巴基斯坦测试人物的信息包括乌尔都语姓名。日本测试人物的信息包括姓名的读音。
打开命令面板并输入 Proxy Mail QA。
| 命令 | 作用 |
|---|---|
| Proxy Mail QA:添加项目的 API 密钥 | 通过项目的 API 密钥 添加项目 |
| Proxy Mail QA:新地址 | 按侧边栏的选项创建测试地址并复制 |
| Proxy Mail QA:等待验证码 | 在你选择的地址等待验证码 |
| Proxy Mail QA:等待链接 | 在你选择的地址等待链接 |
| Proxy Mail QA:复制最新的验证码或链接 | 复制你选择的地址收到的最新验证码或链接 |
| Proxy Mail QA:插入注册测试 | 插入用于注册、重置或魔法链接的 Playwright 或 Cypress 测试 |
| Proxy Mail QA:插入注册表单 | 以 React 或 HTML 代码打开项目的某个注册表单 |
| Proxy Mail QA:插入注册表单的测试 | 为项目的某个注册表单打开 Playwright 或 Cypress 测试 |
| Proxy Mail QA:在 Proxy Mail QA 中打开 | 在应用中打开项目 |
| Proxy Mail QA:删除项目 | 移除项目及其密钥 |
插入注册测试 会询问你要哪种测试,并把它插入到光标位置。同样的测试在 TypeScript 和 JavaScript 文件中也是代码片段:输入 proxymail- 并选择一个。
| 代码片段 | 测试 |
|---|---|
proxymail-signup-playwright |
用新地址注册,并输入邮件中的验证码 |
proxymail-reset-playwright |
借用一个测试账号,通过邮件中的链接重置密码,然后归还 |
proxymail-magic-link-playwright |
通过邮件中的魔法链接登录 |
proxymail-signup-cypress |
注册测试,使用 cy.proxymail |
proxymail-reset-cypress |
重置密码测试,使用 cy.proxymail |
proxymail-magic-link-cypress |
魔法链接测试,使用 cy.proxymail |
这些测试使用 proxymail-qa npm 包。按照 Playwright 或 Cypress 指南进行配置,并在运行测试的环境中设置 PROXYMAIL_QA_API_KEY。
插入注册表单 会询问你要项目的哪个注册表单以及哪种代码:使用 react-hook-form 和 zod 的 React、使用普通 state 的 React,或单个 HTML 页面。它会在新编辑器中打开代码,顶部附有需要检查的说明,并提供复制所需包的安装命令。
插入注册表单的测试 会让你选择表单和测试运行器(Playwright 或 Cypress),然后打开测试,尝试每个字段应接受和应拒绝的值。顶部的说明会指出需要检查的地方,并提供复制安装命令。
每个字段都保留 data-testid,因此表单的自定义字段能填写它。你的编程智能体可以根据截图或你的描述,和你一起构建表单。
该扩展只使用你项目的密钥与 Proxy Mail QA API 通信,不会自行发送任何使用数据。邮件中的验证码、链接和姓名都以文本显示,从不作为网页内容显示。
要删除项目及其密钥,运行 Proxy Mail QA:删除项目。
对本页有疑问?
可以用任何语言提问。文档可以立即回答,你也可以把问题发给 Proxy Mail QA 团队,他们会用英文回复。