Testing Library 最佳实践：是否需显式使用expect断言？

在Testing Library框架中，判断文本是否存在有两种常见写法：

隐含断言写法 #

利用getByText方法找不到目标文本时会抛出错误、直接导致测试失败的特性，无需额外断言语句：

it('sets some text', () => {
  // 前置渲染逻辑
  screen.getByText('someText');
});

显式断言写法 #

结合expect断言和toBeInTheDocument()匹配器，明确声明测试预期：

it('sets some text', () => {
  // 前置渲染逻辑
  expect(screen.getByText('someText')).toBeInTheDocument();
});

两种写法的合规性与选择建议 #

两种写法都是合规的，但各有侧重：

• 隐含断言写法是Testing Library设计允许的用法：getBy*系列方法的核心逻辑就是"匹配不到就抛出错误"，这是框架公开的设计意图，并非隐藏的实现细节。它的优势是代码简洁，但测试失败时的报错信息不够直观，无法直接体现"期望文本存在"的测试意图。
• 显式断言写法可读性更强，能清晰传递测试的预期行为，其他开发者一眼就能明白这段代码是在验证文本是否存在于DOM中。而且toBeInTheDocument()是@testing-library/jest-dom提供的官方匹配器，报错信息更精准，能明确指出断言失败的原因。

如果团队追求代码的可读性和清晰的测试意图，更推荐使用显式断言写法；简单场景下，隐含写法也完全可以用，不存在合规性问题。

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