errorCallback 抽象方法
- Object error,
- StackTrace? stackTrace
当程序性添加到 Future 或 Stream 时,拦截错误。
当调用 Completer.completeError、StreamController.addError 或某些 Future 构造函数时,当前区域允许拦截和替换错误。
当直接接收到错误,例如使用 Future.error,或当同步捕获错误,例如使用 Future.sync 时,Future 构造函数会调用此函数。
无法保证错误只通过 errorCallback 传递一次。使用中间控制器或完成器的库可能最终会多次调用 errorCallback。
如果不需要替换,则返回 null
。否则返回包含新的错误和堆栈跟踪对的 AsyncError 实例。
自定义区域可能拦截此操作。
实现将同步错误转换为异步错误的新异步原语很少需要调用 errorCallback,因为错误通常通过未来完成器或流控制器报告。
实现
AsyncError? errorCallback(Object error, StackTrace? stackTrace);