测试项目从AMD迁移到ES6后QUnit asyncTest用例执行异常如何排查？

你遇到的问题由以下几个可验证的原因共同导致，可按顺序排查：

1. 类型声明与实际运行库版本不匹配 #

• 你当前安装的@types/qunit@^2.0.31是QUnit 2.x版本的类型定义，而tsconfig.json中配置的types字段值为QUnitV1，对应的是QUnit 1.x版本的旧类型声明
• QUnit 1.x提供的全局asyncTestAPI在2.x版本中已被废弃移除，实际运行时调用asyncTest会出现逻辑缺失：测试用例执行后没有触发内置的完成回调，导致进程永远挂起，不会返回用例执行结果

2. ES6模块加载机制与QUnit默认启动逻辑冲突 #

• AMD规范是运行时同步注册测试用例，QUnit默认启动时可以扫描到所有已注册的用例正常执行
• ES6模块是异步延迟加载的，QUnit默认会在脚本加载完成后自动启动执行，此时你的测试用例模块可能还没完成加载注册，QUnit找不到待执行的用例，会出现进程无终止、无结果返回的问题

修复步骤 #

1. 修正类型声明配置：如果实际使用的是QUnit 2.x库，将tsconfig.json的types字段值修改为qunit，和安装的@types/qunit包匹配
2. 替换旧异步API：将所有asyncTest调用替换为QUnit 2.x支持的异步写法，示例如下：

// 旧写法（QUnit 1.x）
asyncTest('测试用例名', function() {
  setTimeout(() => {
    assert.ok(true)
    start()
  }, 100)
})

// 新写法（QUnit 2.x）
QUnit.test('测试用例名', async function(assert) {
  const done = assert.async()
  setTimeout(() => {
    assert.ok(true)
    done()
  }, 100)
})

3. 调整QUnit启动逻辑：在测试入口文件最顶部添加如下配置，关闭自动启动，等所有ES6模块加载完成后手动启动测试：

QUnit.config.autostart = false
// 所有测试用例导入完成后执行
window.addEventListener('load', () => {
  QUnit.start()
})

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