Cypress自定义命令从fixture获取baseUrl时返回命令对象而非预期值的问题
问题原因拆解
- Cypress的所有命令本质是把操作推入一个异步执行队列,不会同步返回真实执行结果,同步调用拿到的永远是命令对象本身
- 你当前写的自定义命令,没有把fixture读取到的baseUrl值通过Cypress的链式机制向下透传,外层调用根本拿不到内部异步解析的字符串值
- 命令内部用外部变量存结果的写法也有问题:命令入队时外部变量还未被赋值,等队列真正执行到fixture读取逻辑时,外层的同步代码已经执行完了,读不到赋值后的值
修复方案
第一步:重写自定义命令
把最终要返回的baseUrl通过cy.wrap()包裹,纳入Cypress的可传递链路,去掉无意义的this上下文绑定、外部变量赋值逻辑,加上配置匹配失败的兜底:
Cypress.Commands.add('getBaseUrl', () => { return cy.fixture('myfile').then((fileList) => { const targetConfig = fileList.find(item => item.instance === Cypress.env('instance')) // 加兜底避免配置缺失时报无意义的下标错误 if (!targetConfig) { throw new Error(`未匹配到instance值为${Cypress.env('instance')}的环境配置`) } // 把真实值包裹后返回,交给Cypress队列传递 return cy.wrap(targetConfig.baseUrl) }) })
小提醒:你当前的fixture文件每个JSON对象最后一个属性后多了冗余逗号,严格JSON解析模式下会触发语法错误,记得删除后再使用。
第二步:用链式方式调用取值
不能把命令的返回值同步塞到另一个命令的参数里,要通过then回调拿到真实解析后的值:
describe('Tests', () => { it('未认证状态下访问/dashboard时会被重定向', () => { cy.getBaseUrl().then((baseUrl) => { // 这里拿到的就是真实的baseUrl字符串,可直接打印、拼接路径 cy.log(`当前环境baseUrl: ${baseUrl}`) // 后续访问、断言逻辑都可以在这个回调里写 cy.visit(`${baseUrl}/dashboard`) }) }) })
补充说明
- 如果需要跨用例全局复用这个baseUrl值,在拿到值之后可以直接写到Cypress环境对象里:
Cypress.env('matchedBaseUrl', baseUrl),后续其他逻辑直接通过Cypress.env('matchedBaseUrl')读取即可,不用重复读fixture - 所有涉及Cypress异步命令返回值的场景,都遵循“入队-执行-回调取值”的逻辑,不要试图通过同步变量、同步拼接的方式拿值,否则永远会拿到未执行完成的命令对象
内容的提问来源于stack exchange,提问作者open-ecommerce.org
相关产品推荐
相关产品推荐

