Cypress自定义命令报错：string无法分配给keyof Chainable类型

AI 小北

2026-8-26

Cypress 10.3.0 JS项目自定义login命令类型错误解决

问题场景

在Cypress的commands.js中添加以下自定义登录命令：

Cypress.Commands.add("login", (email, password) => {
  cy.intercept('POST', '**/auth').as('login');
  cy.visit('/auth');
  cy.get('[formcontrolname="email"]').type(email);
  cy.get('[formcontrolname="password"]').type(password);
  cy.get('form').submit();
  cy.wait('@login').then(xhr => {
    expect(xhr.request.body.email).to.equal(email);
    expect(xhr.request.body.password).to.equal(password);
  });
});

错误提示

Argument type string is not assignable to parameter type keyof Chainable ...  
Type string is not assignable to type "and" | "as" | "selectFile" | "blur" | "check" | "children" | "clear" | "clearCookie" | "clearCookies" | "clearLocalStorage" | "click" | ...    
Type string is not assignable to type "intercept"

解决方法

由于你使用的是JavaScript项目（无index.d.ts类型声明文件），该错误本质是编辑器（如VSCode）自动套用TypeScript类型规则导致的误报，可通过以下方式解决：

方法1：添加`// @ts-nocheck`注释

直接在commands.js文件顶部添加注释，强制关闭该文件的类型检查：

// @ts-nocheck
Cypress.Commands.add("login", (email, password) => {
  // 你的命令代码
});

方法2：配置`jsconfig.json`

在项目根目录创建jsconfig.json文件，全局配置JS项目的类型检查规则：

{
  "compilerOptions": {
    "checkJs": false, // 关闭JS文件的类型检查
    "types": ["cypress"] // 引入Cypress的类型定义以获得语法提示
  },
  "include": ["cypress/**/*"] // 仅包含Cypress相关文件
}