Cypress commands.js调用should断言报undefined读取错误

报错Cannot read properties of undefined (reading 'should')本质是调用should()的主体是undefined，你的代码触发这个问题的最常见原因是LoginPage实例初始化位置错误：
你把const loginPage = new LoginPage()写在了Cypress.Commands.add的外层全局作用域，这段代码会在Cypress加载命令文件的阶段就同步执行，这个时间点远早于测试启动、目标登录页加载完成的时机，页面对象绑定的DOM元素根本不存在，调用元素获取方法自然返回undefined。
如果调整实例位置后报错仍然存在，需要检查LoginPage内部的三个元素获取方法，必须显式return cy.get(对应选择器)的结果，漏写return时方法默认返回undefined，也会触发完全相同的报错。

• 把LoginPage实例的初始化逻辑移到ManualLogin命令的回调函数内部，保证执行登录操作时才创建页面对象实例，匹配Cypress命令排队异步执行的时序。
• 核对PageObject中三个元素获取方法的返回值，确保每个方法都正确返回Cypress链式调用对象。

修复后的自定义命令代码如下：

import LoginPage from '../PageObjects/LoginPage';

Cypress.Commands.add('ManualLogin', () => {
    // 页面对象实例化放在命令执行逻辑内部
    const loginPage = new LoginPage();
    const email = 'testemail'
    const password = 'testpassword'
    loginPage.getEmailInput().should('be.visible').type(email);
    loginPage.getPasswordInput().should('be.visible').type(password);
    loginPage.getLoginButton().should('be.visible').click();
});

踩坑提醒：不要在Cypress的命令文件、测试用例文件的全局作用域初始化依赖页面DOM的对象，全局作用域的代码会在Cypress启动初始化阶段直接运行，和测试执行、页面加载的时序完全错位，很容易出现这类undefined报错。

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