Vest.js 中 omitWhen/skipWhen 内 Eager 模式失效问题解析与修复

问题背景

在 JavaScript 测试验证库 Vest.js 中，开发者发现了一个关于 Eager 模式在条件性测试分组中失效的问题。具体表现为当使用 omitWhen 或 skipWhen 包裹多个测试用例时，即使启用了 Eager 模式（默认行为），后续测试仍会在前置测试失败时继续执行。

问题复现

典型的错误使用场景如下：

omitWhen(exists, () => {
    test('name', 'Error', () => {
        enforce(data.code).isNotEmpty();  // 测试1
    });
    
    test('name', 'Error', () => {
        enforce(data.code).lengthEquals(2);  // 测试2
    });

    test('name', 'Error', async () =>
        await callToBackend(data.name)  // 测试3
    );
});

在这个例子中，即使测试1失败，测试2和测试3仍然会执行，特别是测试3中的异步后端调用会不必要地触发，这与 Eager 模式的预期行为相违背。

技术原理分析

Vest.js 的 Eager 模式设计初衷是：当一个测试失败后，同一字段的后续测试应该被跳过，以提高测试效率和避免不必要的资源消耗。这个机制通过测试运行时的状态管理来实现。

问题的根本原因在于嵌套作用域（nested scope）的创建机制存在缺陷。当测试被包裹在 omitWhen 或 skipWhen 这类条件性分组中时，原有的作用域链管理没有正确处理 Eager 模式的传播，导致分组内部的测试无法感知到同组其他测试的失败状态。

解决方案

Vest.js 维护者在 5.2.7 版本中修复了这个问题。修复方案主要涉及：

1. 重构了嵌套作用域的创建逻辑
2. 确保条件性分组内部能正确继承和传播 Eager 模式状态
3. 完善了作用域链中的测试状态共享机制

最佳实践

对于需要条件性执行的测试组，现在可以安全地使用以下模式：

skipWhen(shouldSkip, () => {
    test('field', 'Required', () => {
        enforce(value).isNotEmpty();  // 基础验证
    });
    
    test('field', 'Invalid format', () => {
        enforce(value).matches(/^[a-z]+$/);  // 格式验证
    });

    test('field', 'Async check', async () => {
        await remoteValidation(value);  // 昂贵的异步验证
    });
});

现在，当基础验证失败时，格式验证和异步验证将按预期被跳过，既保证了验证逻辑的正确性，又提升了测试执行效率。

总结

这个修复使得 Vest.js 的条件性测试分组更加可靠，特别是在涉及：

• 多阶段验证流程
• 包含昂贵操作（如网络请求）的测试
• 复杂的条件性测试场景

开发者现在可以更自信地使用 omitWhen/skipWhen 来组织测试逻辑，同时享受 Eager 模式带来的性能优势。