use_rethrow_when_possible

Use rethrow to rethrow a caught exception.

From Effective Dart:

DO use rethrow to rethrow a caught exception.

As Dart provides rethrow as a feature, it should be used to improve terseness and readability.

BAD:

try {
  somethingRisky();
} catch(e) {
  if (!canHandle(e)) throw e;
  handle(e);
}

GOOD:

try {
  somethingRisky();
} catch(e) {
  if (!canHandle(e)) rethrow;
  handle(e);
}

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

linter:
  rules:
    - use_rethrow_when_possible

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

linter:
  rules:
    use_rethrow_when_possible: true

Unless stated otherwise, the documentation on this site reflects Dart 3.7.0. Page last updated on 2025-01-27. View source or report an issue.