dart:async

Первое свойство

Первый элемент этого потока.

Прекращает прослушивание этого потока после получения первого элемента.

Внутренне метод отменяет свою подписку после получения первого элемента. Это означает, что потоки с одиночной подпиской (не широковещательные) закрываются и не могут быть повторно использованы после вызова этого метода-свойства.

Если событие ошибки возникает до события первого данных, возвращаемое будущее завершается этой ошибкой.

Если этот поток пуст (событие завершения происходит до первого события данных), возвращаемое будущее завершается с ошибкой.

За исключением типа ошибки, этот метод эквивалентен this.elementAt(0).

Реализация

Future<T> get first {
  _Future<T> future = new _Future<T>();
  StreamSubscription<T> subscription =
      this.listen(null, onError: future._completeError, onDone: () {
    try {
      throw IterableElementError.noElement();
    } catch (e, s) {
      _completeWithErrorCallback(future, e, s);
    }
  }, cancelOnError: true);
  subscription.onData((T value) {
    _cancelAndValue(subscription, future, value);
  });
  return future;
}