avoid-nested-try-statements

Reports deeply nested try statements.

max-nesting (integer, default: 2) limits nesting of this construct. Local functions and closures restart the nesting count.

Invalid

example.dartdart

void handle() {
  try {
    try { print(1); } catch (_) {}
  } catch (_) {}
}

Nesting exceeds 1 levels. Extract the nested construct into a helper.

2 try {

3 try { print(1); } catch (_) {}

∙

example.dartdart

void handle() {
  try { print(1); } catch (_) {}
  try { void local() { try { print(2); } catch (_) {} } local(); } catch (_) {}
}

Set its severity in falcon.json. See the configuration guide.

falcon.jsonjson

{
  "linter": {
    "rules": {
      "complexity": {
        "avoid-nested-try-statements": "error"
      }
    }
  }
}

Or silence one occurrence with a suppression comment; the reason is required.

example.dartdart

// falcon-ignore lint/complexity/avoid-nested-try-statements: <reason>

avoid-redundant-asyncavoid-redundant-asyncrecommended
Flags an async function whose body is a single return await ...;.
avoid-unnecessary-containersavoid_unnecessary_containersrecommendedflutter
Flags a Container whose only argument is a child.
avoid-unnecessary-type-assertionsavoid-unnecessary-type-assertionsrecommended
Flags an is check whose result is already guaranteed by the resolved static type.
avoid-unnecessary-type-castsavoid-unnecessary-type-castsrecommended
Flags an as cast to the operand's resolved static type.
cascade-invocationscascade_invocations
Flags consecutive statements that invoke members on the same variable.
cognitive-complexity
Reports function bodies with excessive nesting-weighted control flow.
cyclomatic-complexitycyclomatic_complexity
Flags a function whose cyclomatic complexity exceeds the configured threshold.
join-return-with-assignmentjoin_return_with_assignment
Flags an assignment immediately followed by return of the same variable.