only_throw_errors

Only throw instances of classes extending either Exception or Error.

DO throw only instances of classes that extend dart.core.Error or dart.core.Exception.

Throwing instances that do not extend Error or Exception is a bad practice; doing this is usually a hack for something that should be implemented more thoroughly.

BAD:

void throwString() {
  throw 'hello world!'; // LINT
}

GOOD:

void throwArgumentError() {
  Error error = ArgumentError('oh!');
  throw error; // OK
}

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

linter:
  rules:
    - only_throw_errors

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

linter:
  rules:
    only_throw_errors: 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.