await_only_futures

Await only futures.

AVOID using await on anything which is not a future.

Await is allowed on the types: Future<X>, FutureOr<X>, Future<X>?, FutureOr<X>? and dynamic.

Further, using await null is specifically allowed as a way to introduce a microtask delay.

BAD:

main() async {
  print(await 23);
}

GOOD:

main() async {
  await null; // If a delay is really intended.
  print(23);
}

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

linter:
  rules:
    - await_only_futures

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

linter:
  rules:
    await_only_futures: true

除非另有说明，文档之所提及适用于 Dart 3.7.1 版本，本页面最后更新时间: 2025-01-27。 查看文档源码 或者 报告页面问题。