Dart Future.timeout用法及代码示例

Time-out timeLimit 之后的未来计算已经过去。

如果这个未来及时完成，则返回一个与这个未来具有相同值的新未来。

如果在timeLimit 过去之前这个future 没有完成，那么将执行onTimeout 动作，并将其结果(无论是返回还是抛出)用作返回的future 的结果。 onTimeout 函数必须返回 T 或 Future<T> 。

如果省略 onTimeout ，超时将导致返回的未来以 TimeoutException 完成。

例子：

void main() async {
  var result = await waitTask()
      .timeout(const Duration(seconds: 10));
  print(result); // 'completed'

  result = await waitTask()
      .timeout(const Duration(seconds: 1), onTimeout: () => 'timeout');
  print(result); // 'timeout'

  result = await waitTask()
      .timeout(const Duration(seconds: 2)); // Throws.
}

Future<String> waitTask() async {
  await Future.delayed(const Duration(seconds: 5));
  return 'completed';
}