Cypress测试中模拟对象内断言失败未触发测试失败的解决方法

这个问题我之前也碰到过，核心原因是Cypress的异步执行模型：你在win.GlobalObject.someMethod里写的断言，是被业务代码同步调用的，这个执行过程不在Cypress的命令队列上下文里，导致Cypress无法捕获断言失败的错误，只会在日志里显示异常，但测试整体仍会被标记为成功。

下面是几种可靠的解决方案：

方案1：使用Cypress Spy跟踪方法调用并断言参数 #

这是最推荐的方式，利用Cypress的cy.spy来监视方法调用，之后在Cypress命令链里断言调用参数是否符合预期，确保错误能被Cypress捕获：

it.only('does something', function() { 
  cy.window().then(function(win) { 
    // 创建一个spy并挂载到GlobalObject上，同时别名便于后续引用
    const someMethodSpy = cy.spy((data) => {
      // 可选：这里也可以保留内部断言，但后续的should断言更可靠
      // expect(data).to.deep.eq({ company: 'Pied Piperz', country: 'United States' });
    }).as('someMethod');

    win.GlobalObject = { someMethod: someMethodSpy };
  }); 

  cy.get('[data-cy=submit]').click();

  // 在命令链里断言spy的调用参数，失败会直接标记测试失败
  cy.get('@someMethod').should('have.been.calledWith', { 
    company: 'Pied Piperz', 
    country: 'United States' 
  });
});

方案2：在方法内抛出错误并让Cypress捕获 #

Cypress默认会捕获未处理的JavaScript异常，我们可以在someMethod里手动比较数据，不符合预期时抛出错误，这样Cypress会将其识别为测试失败：

it.only('does something', function() { 
  cy.window().then(function(win) { 
    win.GlobalObject = { 
      someMethod: function(data) { 
        const expected = { company: 'Pied Piperz', country: 'United States' };
        // 深比较数据，这里可以用lodash的_.isEqual（如果项目已引入），或者自定义比较逻辑
        const isMatch = JSON.stringify(data) === JSON.stringify(expected);
        
        if (!isMatch) {
          throw new Error(`数据不匹配：预期 ${JSON.stringify(expected)}，实际 ${JSON.stringify(data)}`);
        }
      } 
    }; 
  }); 

  cy.get('[data-cy=submit]').click();
});

方案3：缓存数据后在Cypress命令链里断言 #

把方法接收到的数据缓存到变量中，之后在Cypress的命令回调里进行断言，确保断言处于Cypress的上下文中：

it.only('does something', function() { 
  let receivedData;

  cy.window().then(function(win) { 
    win.GlobalObject = { 
      someMethod: function(data) { 
        receivedData = data; // 缓存接收到的数据
      } 
    }; 
  }); 

  cy.get('[data-cy=submit]').click()
    .then(() => {
      // 在Cypress命令回调里执行断言，失败会标记测试失败
      expect(receivedData).to.deep.eq({ company: 'Pied Piperz', country: 'United States' });
    });
});

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