dart:async 库

支持异步编程，包含 Future 和 Stream 等类。

Future 和 Stream 是 Dart 中异步编程的基本构建块。它们通过 async 和 async* 函数直接在语言中得到支持，并且通过 dart:core 库对所有库都是可用的。

此库提供了创建、消费和转换 futures 和 streams 的进一步工具，以及直接访问其他异步原语，如 Timer、scheduleMicrotask 和 Zone。

在您的代码中使用此库

import 'dart:async';

Future

Future 对象表示一个可能在未来的某个时间点返回值的计算。Future 在未来某个时间点完成时返回计算的值。Future 经常用于实现在不同线程或 isolate 中的 API（例如，dart:io 的异步 I/O 操作或 dart:html 的 HTTP 请求）。

Dart 库中的许多方法在执行任务时返回 Future。例如，当将 HttpServer 绑定到主机和端口时，bind() 方法返回一个 Future。

 HttpServer.bind('127.0.0.1', 4444)
     .then((server) => print('${server.isBroadcast}'))
     .catchError(print);

Future.then 注册了一个回调函数，在 Future 操作（在这种情况下为 bind() 方法）成功完成时运行。操作返回的值传递给回调函数。在这个例子中，bind() 方法返回 HttpServer 对象。回调函数打印其属性之一。 Future.catchError 注册了一个回调函数，如果在 Future 中发生错误，则运行该回调函数。

Stream

Stream 提供了异步数据序列。数据序列的示例包括单个事件，如鼠标点击，或更大数据块的顺序片段，如包含文件内容的多个字节列表，或从文件中读取的字节列表流。以下示例打开一个文件进行读取。 Stream.listen 注册了在更多数据可用、发生错误或流完成时运行的回调函数。在 Stream 上提供了更多功能，通过调用 Stream.listen 来获取实际数据。

Stream<List<int>> stream = File('quotes.txt').openRead();
stream.transform(utf8.decoder).forEach(print);

此流发出一系列字节列表。然后程序必须以某种方式处理这些字节列表。在这里，代码使用 UTF-8 解码器（由 dart:convert 库提供）将字节序列转换为 Dart 字符串序列。

流的另一个常见用途是在 Web 应用中处理用户生成的事件：以下代码监听按钮上的鼠标点击。

querySelector('#myButton')!.onClick.forEach((_) => print('Click.'));

其他资源

• 库之旅中 dart:async 部分：异步编程的简要概述。

• 使用基于 Future 的 API：更深入地了解 Future 及其如何用于编写异步 Dart 代码。

• Future 和错误处理：关于在处理 Future 时处理错误和异常的所有你想知道的内容（但你可能害怕询问）。

• 事件循环与 Dart：了解 Dart 如何处理事件队列和微任务队列，以便您可以使用更少的惊喜编写更好的异步代码。

• test package: 异步测试：如何测试异步代码。