如何在Dart中像JavaScript那样显式解析Future（或其他可等待类型）？

嘿，这个问题问到点子上了！在JavaScript里我们常靠new Promise((resolve, reject) => { ... })手动拿捏异步操作的成败，Dart里的Future虽然API不同，但也有对应的玩法——核心就是用Completer类来手动触发完成或失败状态。

1. 手动"resolve"一个Future（成功完成） #

对应JS里的resolve操作，Dart中我们可以通过Completer的complete()方法来手动标记Future成功完成，并传入返回结果。示例代码如下：

import 'dart:async';

Future<String> fetchMockData() {
  // 创建Completer实例，它是连接Future和手动控制逻辑的桥梁
  final completer = Completer<String>();

  // 模拟一个耗时的异步操作，比如延迟2秒返回数据
  Timer(const Duration(seconds: 2), () {
    // 手动触发"resolve"，把结果传递给等待这个Future的代码
    completer.complete("Mock数据加载完成！");
  });

  // 返回Completer关联的Future对象
  return completer.future;
}

// 使用这个Future
void main() async {
  try {
    final data = await fetchMockData();
    print(data); // 输出：Mock数据加载完成！
  } catch (e) {
    print(e);
  }
}

2. 手动"reject"一个Future（抛出错误） #

对应JS里的reject，Dart用Completer的completeError()方法来手动触发Future的失败状态，你可以传入错误对象，还能附加栈追踪信息帮助调试。示例：

import 'dart:async';

Future<String> fetchFailedData() {
  final completer = Completer<String>();

  Timer(const Duration(seconds: 2), () {
    // 手动触发"reject"，传递错误信息
    completer.completeError(Exception("模拟网络请求失败！"));
  });

  return completer.future;
}

// 使用并捕获错误
void main() async {
  try {
    final data = await fetchFailedData();
    print(data);
  } catch (e) {
    print(e); // 输出：Exception: 模拟网络请求失败！
  }
}

3. 什么时候需要用Completer？ #

大部分场景下，Dart可以直接用async/await或者快捷方法Future.value(结果)、Future.error(错误)来创建Future，但当你需要在回调式API（比如Timer、原生平台调用、第三方SDK的回调）中手动控制Future状态时，Completer就是最佳选择——这和JS里用Promise封装回调API的场景完全一致。

举个封装原生回调的例子：

import 'dart:async';

// 假设这是一个第三方原生SDK的回调式方法
void nativeLogin(String username, String password, Function(bool success, String msg) callback) {
  // 模拟原生登录逻辑
  Timer(const Duration(seconds: 1), () {
    if (username == "admin" && password == "123") {
      callback(true, "登录成功");
    } else {
      callback(false, "账号密码错误");
    }
  });
}

// 用Completer把回调式方法转换成Future
Future<String> login(String username, String password) {
  final completer = Completer<String>();
  nativeLogin(username, password, (success, msg) {
    if (success) {
      completer.complete(msg);
    } else {
      completer.completeError(Exception(msg));
    }
  });
  return completer.future;
}

// 使用转换后的Future
void main() async {
  try {
    final result = await login("admin", "123");
    print(result); // 输出：登录成功
  } catch (e) {
    print(e);
  }
}

内容的提问来源于stack exchange，提问作者A.A