unnecessary_await_in_return

Unnecessary await keyword in return.

Avoid returning an awaited expression when the expression type is assignable to the function's return type.

BAD:

Future<int> future;
Future<int> f1() async => await future;
Future<int> f2() async {
  return await future;
}

GOOD:

Future<int> future;
Future<int> f1() => future;
Future<int> f2() {
  return future;
}

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

linter:
  rules:
    - unnecessary_await_in_return

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

linter:
  rules:
    unnecessary_await_in_return: true

Unless stated otherwise, the documentation on this site reflects Dart 3.6.2. Page last updated on 2025-01-27. View source or report an issue.