dart:async 库

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

Future 和 Stream 是 Dart 中异步编程的基本构建块。通过 async 和 async* 函数语言直接支持，并通过 dart:core 库对所有库开放。

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

在您的代码中使用此库

import 'dart:async';

Future

Future 对象表示一个可能在未来某个时间点返回值的计算。Future 在完成时返回计算的值。Future 通常用于使用不同线程或隔离实现的 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：更详细地了解 Futures 及其如何用于编写异步 Dart 代码。

• Futures 和错误处理：关于处理使用 Futures 时发生的错误和异常的所有信息（但您可能害怕询问）。

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

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