使用Cypress Module API调用Chrome时提示浏览器未找到的问题

核心原因 #

你遇到的报错根源在于：

• 配置里通过setupNodeEvents过滤掉了Electron浏览器，但调用cypress.run()时没明确指定用Chrome，Cypress默认尝试启动Electron，而它已经被过滤，所以触发“找不到electron”的错误。
• 原配置中setupNodeEvents只返回{browsers: ...}，会覆盖整个Cypress配置对象，导致其他必要配置丢失；同时filter回调返回浏览器对象而非布尔值（虽能生效，但不符合规范）。

解决步骤 #

1. 在Module API启动时明确指定Chrome

修改example-test.js，添加browser: 'chrome'参数，直接指定启动浏览器：

const cypress = require('cypress')

cypress.run({
  spec: './cypress/e2e/simple-login.cy.js',
  browser: 'chrome' // 强制指定使用Chrome
}).then((result) => {
    console.log('测试结果:', result);
    // 根据失败数设置退出码，适配CI环境需求
    process.exit(result.totalFailed > 0 ? 1 : 0);
}).catch((err) => {
    console.error('测试启动失败:', err);
    process.exit(1);
})

2. 修复配置文件的过滤逻辑

修改cypress.config.js，确保返回完整配置对象，且filter回调返回布尔值：

const { defineConfig } = require('cypress')

module.exports = defineConfig({
  fixturesFolder: false,
  e2e: {
      experimentalSessionAndOrigin: true,
      setupNodeEvents(on, config) {
          // 过滤出Chrome浏览器，用布尔值判断
          config.browsers = config.browsers.filter(browser => browser.name === 'chrome');
          console.log('当前可用浏览器:', config.browsers);
          // 返回完整的修改后配置，而非仅browsers字段
          return config;
      }
  },
})

额外说明 #

• 关于Electron无法定位元素的问题，通常是因为Electron内置的Chromium版本与本地Chrome不一致，导致页面渲染、JS执行存在差异。既然你的需求是使用Chrome，解决上述问题后即可规避该问题。
• 执行命令仍为node example-test.js，此时会直接启动Chrome运行测试，和npx cypress run --browser chrome效果一致。

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