unawaited function

void unawaited(
  1. Future<void>? future
)

Indicates to tools that future is intentionally not await-ed.

In an async context, it is normally expected that all Futures are awaited, and that is the basis of the lint unawaited_futures. However, there are times where one or more futures are intentionally not awaited. This function may be used to ignore a particular future. It silences the unawaited_futures lint.

Future<void> saveUserPreferences() async {
  await _writePreferences();

  // While 'log' returns a Future, the consumer of 'saveUserPreferences'
  // is unlikely to want to wait for that future to complete; they only
  // care about the preferences being written).
  unawaited(log('Preferences saved!'));
}

Implementation

void unawaited(Future<void>? future) {}