前些天同事突然发现一个库项目的测试无法运行,报错的内容大概是:cannot use import statement outside a module "should"
,即无法在模块外使用 import
导入内容。这个错误比较奇怪,简单 Google 之,基本上大家的解决方案都是使用 <script type="module">
即在浏览器里用 ESM 加载 JS,这明显和我们的环境不同。
Node.js 当然也支持 ESM,不过这应该也不是问题症结。大体上我可以判断,因为测试集(JS 文件)用到 import
语法,而且用 mocha --require @babel/register
启动测试,所以应该是 Babel 没有正确转译导致的问题。
检查 Babel 的相关配置,发现同事为了能同时编译现代浏览器和 IE 两个版本的库,.babelrc
大概是这样的:
{
"env": {
"default": {
"presets": [],
},
"withie": {
"presets": [],
}
}
}
猜测 mocha 走了 default
分支,然后没有转译,所以出错。解决方案就是添加 node
分支,以当前 node 版本为 target
,这样该转译就转译,不转译就用原生,性能更好,修改好的配置大概是这样的:
{
"env": {
"default": {"presets": []},
"withie": {"presets": []},
"node": {
"presets": [
[
"@babel/preset-env",
{
"targets": {
"node": "current"
},
"useBuiltIns": false
}
]
]
}
}
}
使用时,需要增加环境变量用来切换配置:BABEL_ENV=node mocha --require @babel/register
。比较奇怪的是,其他脚本使用 BROWSERSLIST_ENV
切换,这里只能使用 BABEL_ENV
,我暂时不知道为什么。
修改之后的脚本就可以正常测试了。接下来我打算给它加上 Travis,这样就能自动 lint + 测试,比较方便控制质量。加 Travis 很简单,拷过来一个 .travis.yml
改吧改吧就行了,但是第一次运行失败了,而且是超时。经过研究,原来 mocha 从 v4 开始,完成测试后不会自动退出,除非手动指定,方法是增加 --exit
参数。
所以最终的测试脚本是(其它配置略去):
{
"scripts": {
"test": "BABEL_ENV=node mocha --require @babel/register --exit",
}
}
最终 Travis 配置是:
sudo: required
dist: trusty
language: node_js
node_js:
- 14
branches:
only:
- master
cache:
directories:
- ~/.npm # cache npm's cache
- ~/npm # cache latest npm
install:
- npm ci
script:
- npm run lint
- npm run test
欢迎吐槽,共同进步