用真实的 Gmail 账号作为测试收件箱,一开始能用。下面是它通常会出问题的地方。
会在哪里出问题
- 令牌会过期。 同意屏幕处于 Testing 状态的 OAuth 应用拿到的刷新令牌会在 7 天后过期。流水线会一直失败,直到有人登录并复制一个新令牌进去。
- 受限权限范围。 读取邮件需要 Gmail 的受限权限范围之一。把应用移出 Testing 状态可能需要通过 Google 的验证,某些用途还需要安全评估,这对一个测试辅助工具来说代价太大。
- 所有运行共用一个收件箱。 加号地址(
qa+run123@gmail.com)让每个测试有自己的地址,但每封邮件仍然进入同一个邮箱。并行运行会读到彼此的验证码,重试也可能取到上一次尝试的验证码。 - 固定等待和脆弱的解析。 脚本用
sleep轮询,再用正则表达式取出验证码,而市场团队哪天改了邮件模板,它就会失效。 - 流程里需要人。 当 Google 要求确认登录时,测试无法回应,只能由拿着手机的人来处理。
改为每个测试一个地址
Proxy Mail QA 为每个测试提供自己的地址和收件箱,然后等待某个时间之后到达的邮件:
import { ProxyMailQA } from 'proxymail-qa';
const qa = new ProxyMailQA(); // reads PROXYMAIL_QA_API_KEYconst { address } = await qa.createAddress({ label: 'sign-up test' });
const since = new Date();// …fill in the sign-up form with `address` and submit…const { value: code } = await qa.waitForCode(address, { since });- 无需续期令牌。 API 密钥 不会在一周后过期。把它存放在你的 CI secrets 中。
- 不会冲突。 每个地址只属于一个测试,所以并行运行永远看不到彼此的邮件。
- 无需正则表达式。 验证码或链接会直接返回,并附带到达时间。
- 无需固定休眠。 邮件一到,等待就会返回,而
since确保不会返回更早的验证码。
迁移过来
- 把注册步骤中的 Gmail 地址换成
createAddress提供的新地址。 - 用
waitForCode或waitForLink替换收件箱轮询和正则表达式。 - 从 CI 中删除 Gmail 凭据,以及续期令牌的任务。
Playwright、Cypress 和 pytest 指南展示了在各个框架中的相同步骤。