unnecessary_unawaited

Unnecessary use of 'unawaited'.

A call to a function, method, or operator, or a reference to a field, getter, or top-level variable which is annotated with @awaitNotRequired does not need to be wrapped in a call to unawaited().

BAD:

@awaitNotRequired
Future<LogMessage> log(String message) { ... }

void f() {
  unawaited(log('Message.'));
}

GOOD:

@awaitNotRequired
Future<LogMessage> log(String message) { ... }

void f() {
  log('Message.');
}

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

linter:
  rules:
    - unnecessary_unawaited

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

linter:
  rules:
    unnecessary_unawaited: true

Unless stated otherwise, the documentation on this site reflects Dart 3.8.0. Page last updated on 2025-03-07. View source or report an issue.