errorCallback 抽象方法

AsyncError? errorCallback(
  1. Object error,
  2. StackTrace? stackTrace
)

当将错误以编程方式添加到FutureStream时,拦截错误。

当调用Completer.completeErrorStreamController.addError或某些Future构造函数时,当前区域可以拦截并替换错误。

Future构造函数在直接接收错误时调用此函数,例如使用Future.error,或者当错误被同步捕获时调用,例如使用Future.sync

无法保证错误只通过errorCallback发送一次。使用中间控制器或完成者的库可能会多次调用errorCallback

如果不希望替换,则返回null。否则返回一个包含新错误和堆栈跟踪对的AsyncError实例。

自定义区域可以拦截此操作。

实现将同步错误转换为异步错误的新异步原语时很少需要调用errorCallback,因为错误通常是通过对future完成者或stream控制器进行报告。

实现

AsyncError? errorCallback(Object error, StackTrace? stackTrace);