use_rethrow_when_possible

Use 'rethrow' to rethrow a caught exception.

The analyzer produces this diagnostic when a caught exception is thrown using a throw expression rather than a rethrow statement.

The following code produces this diagnostic because the caught exception e is thrown using a throw expression:

void f() {
  try {
    // ...
  } catch (e) {
    throw e;
  }
}

Use rethrow instead of throw:

void f() {
  try {
    // ...
  } catch (e) {
    rethrow;
  }
}

Unless stated otherwise, the documentation on this site reflects Dart 3.8.1. Page last updated on 2025-05-08. View source or report an issue.