跳转至主要内容
目录

use_test_throws_matchers

目录
Stable

Use throwsA matcher instead of fail().

Details

#

Use the throwsA matcher instead of try-catch with fail().

BAD:

dart
// sync code
try {
  someSyncFunctionThatThrows();
  fail('expected Error');
} on Error catch (error) {
  expect(error.message, contains('some message'));
}

// async code
try {
  await someAsyncFunctionThatThrows();
  fail('expected Error');
} on Error catch (error) {
  expect(error.message, contains('some message'));
}

GOOD:

dart
// sync code
expect(
  () => someSyncFunctionThatThrows(),
  throwsA(isA<Error>().having((Error error) => error.message, 'message', contains('some message'))),
);

// async code
await expectLater(
  () => someAsyncFunctionThatThrows(),
  throwsA(isA<Error>().having((Error error) => error.message, 'message', contains('some message'))),
);

Enable

#

To enable the use_test_throws_matchers rule, add use_test_throws_matchers under linter > rules in your analysis_options.yaml file:

analysis_options.yaml
yaml
linter:
  rules:
    - use_test_throws_matchers

If you're instead using the YAML map syntax to configure linter rules, add use_test_throws_matchers: true under linter > rules:

analysis_options.yaml
yaml
linter:
  rules:
    use_test_throws_matchers: true

除非另有说明，文档之所提及适用于 Dart 3.9.0 版本，本页面最后更新时间: 2025-08-07。 查看文档源码 或者 报告页面问题.