Future<T>.sync constructor

Future<T>.sync(
  1. FutureOr<T> computation()
)

Returns a future containing the result of immediately calling computation.

If calling computation throws, the returned future is completed with the error.

If calling computation returns a Future<T>, that future is returned.

If calling computation returns a non-future value, a future is returned which has been completed with that value.

Example:

final result = await Future<int>.sync(() => 12);

Implementation

factory Future.sync(FutureOr<T> computation()) {
  try {
    var result = computation();
    return result is Future<T> ? result : _Future<T>.value(result);
  } catch (error, stackTrace) {
    var future = new _Future<T>();
    AsyncError? replacement = Zone.current.errorCallback(error, stackTrace);
    if (replacement != null) {
      future._asyncCompleteError(replacement.error, replacement.stackTrace);
    } else {
      future._asyncCompleteError(error, stackTrace);
    }
    return future;
  }
}