如何在Vitest中自定义expect断言提示信息？

方法1：使用Vitest内置的.withContext() #

Vitest的expect对象原生支持.withContext()方法，可为断言添加自定义上下文信息，测试失败时会自动显示该内容。示例：

// 测试加法运算是否正确
expect(1 + 1).withContext('请确认你是否正确执行了加法运算，结果应为2').toBe(3);

断言失败时，控制台会输出你传入的提示消息，帮助学生快速定位问题。

方法2：自定义匹配器 #

如果需要更灵活的提示逻辑，可通过expect.extend()扩展匹配器，把提示消息作为参数传入：

import { expect } from 'vitest';

// 扩展自定义匹配器
expect.extend({
  toEqualWithMsg(received, expected, msg) {
    const pass = received === expected;
    return {
      pass,
      message: () => pass ? '测试通过' : msg || `实际值: ${received} 不等于 期望值: ${expected}`
    };
  }
});

// 使用自定义匹配器
expect(studentAnswer).toEqualWithMsg(correctAnswer, '你的答案不正确，请重新审题后再尝试');

这种方式适合统一定制提示风格，给学生的提示可以更友好、更具针对性。

方法3：捕获断言错误并自定义抛出 #

在测试用例中，可通过try/catch捕获断言错误，然后抛出自定义信息：

test('检查学生的计算结果', () => {
  try {
    expect(studentResult).toBe(correctResult);
  } catch (error) {
    throw new Error('你的计算结果有误，请检查公式是否正确，或者计算过程中是否出现了笔误');
  }
});

这种方式适合需要完全自定义错误输出格式的场景，但相对繁琐。

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