如何在WebdriverIO中执行所有测试通过后的收尾脚本？

排查步骤与解决方案 #

1. 确认钩子的正确层级与配置结构 #

WebdriverIO的全局after钩子需要直接放在配置文件的根层级，不能嵌套在Mocha/Jasmine等测试框架的选项中。正确的配置结构示例：

exports.config = {
    // 其他核心配置（specs、capabilities等）
    after: async function () {
        await deleteAllDataFromAccount();
    },
    // 测试框架配置（如mochaOpts）
    mochaOpts: {
        ui: 'bdd',
        timeout: 60000
    }
}

若将after放入mochaOpts内，钩子不会被WebdriverIO识别执行。

2. 验证钩子是否被触发 #

在钩子开头添加日志输出，确认代码是否进入该逻辑：

after: async function () {
    console.log('已进入after钩子');
    await deleteAllDataFromAccount();
}

运行测试后查看控制台，若未输出日志，说明钩子未被触发，需重新检查配置结构或版本兼容性。

3. 排查测试进程是否提前终止 #

如果测试过程中出现未捕获的错误、进程崩溃，或代码中使用process.exit()强制退出，after钩子会因进程中断无法执行。需确保测试流程正常结束，无强制退出逻辑。

4. 确认异步函数的正确性 #

检查deleteAllDataFromAccount函数是否为合法的异步函数，是否存在未处理的Promise拒绝。添加错误捕获排查问题：

after: async function () {
    try {
        await deleteAllDataFromAccount();
        console.log('数据删除完成');
    } catch (err) {
        console.error('数据删除失败:', err);
    }
}

若函数内部存在未捕获的错误，会导致钩子静默失败，看起来像是“未生效”。

5. 适配WebdriverIO版本差异 #

不同版本的WebdriverIO对钩子定义有区别：

• v7及以上版本：全局钩子直接放在配置根层级
• v6及更早版本：需通过hooks对象定义钩子
  旧版本适配示例：

// WebdriverIO v6及更早版本
exports.config = {
    hooks: {
        after: async function () {
            await deleteAllDataFromAccount();
        }
    }
}

6. 实现“仅测试全通过时执行”的逻辑（可选） #

如果你的需求是仅当所有测试用例都通过才执行脚本，默认after钩子会无视测试结果触发，需手动判断测试状态：

after: async function (results) {
    if (results.passed === results.total) {
        await deleteAllDataFromAccount();
    }
}

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