dart:async

Метод errorCallback абстрактного типа

Перехватывает ошибки, добавляемые программно в Future или Stream.

При вызове Completer.completeError, StreamController.addError или некоторых конструкторов Future, текущая зона может перехватить и заменить ошибку.

Конструкторы Future вызывают эту функцию при получении ошибки напрямую, например, с Future.error, или когда ошибка обрабатывается синхронно, например, с Future.sync.

Нет гарантии, что ошибка будет отправлена через errorCallback только один раз. Библиотеки, использующие промежуточные контроллеры или комплетеры, могут вызывать errorCallback несколько раз.

Возвращает null если замена не требуется. В противном случае возвращает экземпляр AsyncError, содержащий новую пару ошибки и трассировки стека.

Хотя не рекомендуется, возвращаемый экземпляр может иметь свой член error (AsyncError.error) равным null, в этом случае ошибку следует заменить на NullThrownError.

Пользовательские зоны могут перехватить эту операцию.

Реализации новой асинхронной примитива, преобразующей синхронные ошибки в асинхронные, редко нуждаются в вызове errorCallback, так как ошибки обычно сообщаются через будущие комплетеры или контроллеры потока.

Источник

AsyncError errorCallback(Object error, StackTrace stackTrace);