description

# first property

Future<T> get first

The first element of this stream.

Stops listening to this stream after the first element has been received.

Internally the method cancels its subscription after the first element. This means that single-subscription (non-broadcast) streams are closed and cannot be reused after a call to this getter.

If an error event occurs before the first data event, the returned future is completed with that error.

If this stream is empty (a done event occurs before the first data event), the returned future completes with an error.

Except for the type of the error, this method is equivalent to `this.elementAt(0)`.

## Implementation

    Future<T> get first {
      @pragma('vm:awaiter-link')
      _Future<T> future = _Future<T>();
      StreamSubscription<T> subscription = this.listen(
        null,
        onError: future._completeError,
        onDone: () {
          var stack = StackTrace.current;
          var error = IterableElementError.noElement();
          _trySetStackTrace(error, stack);
          _completeWithErrorCallback(future, error, stack);
        },
        cancelOnError: true,
      );
      subscription.onData((T value) {
        _cancelAndValue(subscription, future, value);
      });
      return future;
    }