avoid_catches_without_on_clauses

Avoid catches without on clauses.

此规则自 Dart 2.0 版本起可用。

From Effective Dart:

AVOID catches without on clauses.

Using catch clauses without on clauses make your code prone to encountering unexpected errors that won't be thrown (and thus will go unnoticed).

BAD:

try {
 somethingRisky()
} catch(e) {
  doSomething(e);
}

GOOD:

try {
 somethingRisky()
} on Exception catch(e) {
  doSomething(e);
}

A few exceptional cases are allowed:

• If the body of the catch rethrows the exception.
• If the caught exception is "directly used" in an argument to Future.error, Completer.completeError, or FlutterError.reportError, or any function with a return type of Never.
• If the caught exception is "directly used" in a new throw-expression.

In these cases, "directly used" means that the exception is referenced within the relevant code (like within an argument). If the exception variable is referenced before the relevant code, for example to instantiate a wrapper exception, the variable is not "directly used."

要启用 avoid_catches_without_on_clauses 规则，请在你的 analysis_options.yaml 文件中，在 linter > rules 下添加 avoid_catches_without_on_clauses ：

linter:
  rules:
    - avoid_catches_without_on_clauses

除非另有说明，否则本网站上的文档反映的是 Dart 3.6.0。页面最后更新于 2025-02-05。 查看源代码 或 报告问题.