use_rethrow_when_possible

Use rethrow to rethrow a caught exception.

This rule is available as of Dart 2.0.

Rule sets: recommended, flutter

This rule has a quick fix available.

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

Unless stated otherwise, the documentation on this site reflects Dart 3.6.0. Page last updated on 2024-07-03. View source or report an issue.