最新版WebdriverIO能否用require()替代import？升级遇问题求助

最新版WebdriverIO（v8及以上）完全支持使用require()替代import进行模块引入，两者兼容。升级后遇到问题，基本是项目配置或环境适配导致，以下是常见问题的解决思路：

常见问题及解决办法 #

• 配置文件模块格式冲突
  如果你的wdio.conf.js使用ES模块语法（如export），但业务代码用require()，会触发Node.js模块解析冲突。解决方式二选一：

  • 将配置文件改为CommonJS格式，用module.exports替代export；
  • 在项目根目录的package.json中设置"type": "commonjs"（若之前为"type": "module"）。

• 第三方依赖模块格式不兼容
  部分第三方依赖仅提供ES模块版本，直接用require()引入会报错。解决方式：

  • 改用动态导入：await import('依赖包名')；
  • 配置Babel转译ES模块为CommonJS，在wdio.conf.js中添加Babel相关配置。

• TypeScript配置异常（若使用TS）
  若项目基于TypeScript，tsconfig.json的module选项设为ESNext/ES6时，编译后的代码无法被require()识别。解决：

  • 修改tsconfig.json，将module设为CommonJS，target设为ES2015或更低版本；
  • 在wdio.conf.js的tsNodeOpts中添加module: 'commonjs'配置，确保ts-node适配CommonJS。

• Node.js版本不符合要求
  WebdriverIO v8要求Node.js版本≥16.17，旧版本对模块兼容性处理存在缺陷，升级Node.js到符合要求的版本即可。

CommonJS风格测试文件示例 #

const { expect } = require('@wdio/globals')
const LoginPage = require('../pageobjects/login.page')

describe('登录测试', () => {
    it('应该成功登录', async () => {
        await LoginPage.open()
        await LoginPage.login('测试用户', '测试密码')
        await expect($('#dashboard')).toBeDisplayed()
    })
})

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