unnecessary_unawaited
Unnecessary use of 'unawaited'.
Details
#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:
dart
@awaitNotRequired
Future<LogMessage> log(String message) { ... }
void f() {
unawaited(log('Message.'));
}
GOOD:
dart
@awaitNotRequired
Future<LogMessage> log(String message) { ... }
void f() {
log('Message.');
}
Enable
#To enable the unnecessary_unawaited
rule, add unnecessary_unawaited
under linter > rules in your analysis_options.yaml
file:
analysis_options.yaml
yaml
linter:
rules:
- unnecessary_unawaited
If you're instead using the YAML map syntax to configure linter rules, add unnecessary_unawaited: true
under linter > rules:
analysis_options.yaml
yaml
linter:
rules:
unnecessary_unawaited: true
Was this page's content helpful?
Thank you for your feedback!
Provide details Thank you for your feedback! Please let us know what we can do to improve.
Provide details Unless stated otherwise, the documentation on this site reflects Dart 3.8.1. Page last updated on 2025-03-07. View source or report an issue.