dart:async

listen — абстрактный метод

Добавляет подписку на этот поток.

Возвращает StreamSubscription, который обрабатывает события этого потока с помощью указанных обработчиков onData, onError и onDone. Обработчики можно изменить в подписке, но изначально используются переданные функции.

При каждом событии данных из этого потока вызывается обработчик подписчика onData. Если onData — null, ничего не происходит.

При ошибках в этом потоке обработчик onError вызывается с объектом ошибки и, возможно, трассировкой стека.

Функция обратного вызова onError должна иметь тип void Function(Object error) или void Function(Object error, StackTrace). Тип функции определяет, вызывается ли onError с аргументом трассировки стека. Аргумент трассировки стека может быть равен StackTrace.empty, если этот поток получил ошибку без трассировки стека.

В противном случае она вызывается только с объектом ошибки. Если onError не указан, любые ошибки в этом потоке считаются необработанными и передаются обработчику ошибок текущей зоны Zone. По умолчанию необработанные асинхронные ошибки обрабатываются так же, как неперехваченные ошибки верхнего уровня.

Если этот поток закрывается и отправляет событие завершения, вызывается обработчик onDone. Если onDone — null, ничего не происходит.

Если cancelOnError — true, подписка автоматически отменяется при доставке первого события ошибки. По умолчанию используется false.

Пока подписка приостановлена или отменена, она не получает события, и ни одна из функций-обработчиков событий не вызывается.

Реализация

StreamSubscription<T> listen(void onData(T event)?,
    {Function? onError, void onDone()?, bool? cancelOnError});