Cypress报错：cy.type()仅接受字符串/数字，传入undefined求排查

核心问题 #

cy.type()抛出这个错误，是因为Cypress.env('USER_LOGIN_EMAIL')或Cypress.env('USER_LOGIN_PASSWORD')返回了undefined，导致输入方法接收到了非法参数。

具体排查方向及解决办法 #

• 环境变量配置缺失
  检查项目根目录的cypress.env.json文件，确认是否存在USER_LOGIN_EMAIL和USER_LOGIN_PASSWORD两个键，且对应的值是有效的字符串/数字。正确的配置示例：

  {
    "USER_LOGIN_EMAIL": "test@example.com",
    "USER_LOGIN_PASSWORD": "your-password-here"
  }
  

• 命令行传参错误
  如果是通过命令行传入环境变量（比如CYPRESS_USER_LOGIN_EMAIL=xxx CYPRESS_USER_LOGIN_PASSWORD=xxx npx cypress run），检查变量名拼写是否正确，必须以CYPRESS_作为前缀。

• 配置文件加载逻辑问题
  若在cypress.config.js中自定义了环境变量加载逻辑，确认代码没有覆盖或遗漏这两个登录变量，确保配置文件正确读取了对应的值。

• 临时调试验证
  可以在代码中添加日志输出，直接确认变量值：

  enterEmail(){
      const email = Cypress.env('USER_LOGIN_EMAIL')
      cy.log('当前邮箱环境变量值:', email) // 在Cypress控制台查看日志
      return cy.get('input[type="email"]').type(email)
  }
  

  如果日志显示undefined，说明变量确实未加载完成，重点排查配置环节。

内容的提问来源于stack exchange，提问作者Hina Faran