You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用cypress-await插件时出现模块找不到错误求助

解决Cypress中cypress-await模块找不到的问题
  • 确认本地依赖安装状态
    检查项目根目录的package.json,确认cypress-await已在devDependencies中。如果没有,执行本地安装命令:

    npm install cypress-await --save-dev
    # 或使用yarn
    yarn add cypress-await -D
    

    注意:必须安装为项目本地依赖,全局安装无法被Cypress识别。

  • 配置Cypress加载插件
    在项目根目录的cypress.config.js(或cypress.config.ts)中,确保正确注册cypress-await插件:

    const { defineConfig } = require('cypress')
    const installCypressAwait = require('cypress-await/lib/install')
    
    module.exports = defineConfig({
      e2e: {
        setupNodeEvents(on, config) {
          installCypressAwait(on)
        },
      },
    })
    

    TypeScript项目可调整为对应的导入语法。

  • 检查测试文件的导入语句
    在你的E2E测试文件顶部,添加正确的导入:

    import 'cypress-await'
    

    避免拼写错误(比如误写为cypress-async)。

  • 清理缓存并重启Cypress
    执行以下命令清理依赖缓存,重新安装后重启Cypress Runner:

    rm -rf node_modules package-lock.json
    npm install
    npx cypress open
    

    这能解决缓存导致的模块路径识别异常。

  • 规范测试文件路径
    确保测试文件放在项目的cypress/e2e目录下,不要直接运行临时目录中的测试文件(错误信息中的路径为Cypress运行时生成的临时文件,并非你的源测试文件)。

内容的提问来源于stack exchange,提问作者waqar anwar

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.05 15:17:37