Cypress自定义命令报错：Cypress.Commands.add无法分配给Chainable类型参数

你遇到的Cypress.Commands.add is not assignable to parameter of type 'keyof Chainable'是TypeScript类型校验报错，本质是自定义命令没在Cypress的类型声明里注册，导致TS识别不了新命令。按以下步骤修复：

• 创建/编辑类型声明文件
  在cypress/support目录下新建commands.d.ts文件（已有则直接编辑），把你添加的自定义命令类型写进去。比如你加的是loginToAzure命令，就写：

  declare namespace Cypress {
    interface Chainable {
      loginToAzure(username: string, password: string): Chainable<void>;
      // 其他自定义命令也在这里补充类型定义
    }
  }
  

  注意把命令名、参数类型改成你实际使用的内容。

• 配置TS识别类型文件
  打开cypress/tsconfig.json，确保include数组包含这个声明文件：

  {
    "compilerOptions": {
      "target": "es5",
      "lib": ["es5", "dom"],
      "types": ["cypress"]
    },
    "include": ["**/*.ts", "./support/commands.d.ts"]
  }
  

• 重启Cypress服务
  关闭当前运行的Cypress窗口，重新启动测试服务，让TypeScript重新加载类型声明。

另外要注意，Cypress 10+版本的自定义命令要写在cypress/support/e2e.ts或单独的commands.ts里，并且确保在e2e.ts中正确导入了命令文件。

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