An object representing an ongoing Ticker sequence.

The Ticker.start method returns a TickerFuture. The TickerFuture will complete successfully if the Ticker is stopped using Ticker.stop with the canceled argument set to false (the default).

If the Ticker is disposed without being stopped, or if it is stopped with canceled set to true, then this Future will never complete.

This class works like a normal Future, but has an additional property, orCancel, which returns a derivative Future that completes with an error if the Ticker that returned the TickerFuture was stopped with canceled set to true, or if it was disposed without being stopped.

To run a callback when either this future resolves or when the tricker is canceled, use whenCompleteOrCancel.

Implements

Constructors

TickerFuture.complete()
Creates a TickerFuture instance that represents an already-complete Ticker sequence. [...]

Properties

orCancel Future<Null>
A future that resolves when this future resolves or throws when the ticker is canceled.
read-only
hashCode int
The hash code for this object. [...]
read-only, inherited
runtimeType Type
A representation of the runtime type of the object.
read-only, inherited

Methods

asStream() Stream<Null>
Creates a Stream containing the result of this future. [...]
catchError(Function onError, { bool test(error) }) Future<Null>
Handles errors emitted by this Future. [...]
then<E>(dynamic f(Null value), { Function onError }) Future<E>
Register callbacks to be called when this future completes. [...]
timeout(Duration timeLimit, { dynamic onTimeout() }) Future<Null>
Time-out the future computation after timeLimit has passed. [...]
toString() String
Returns a string representation of this object.
whenComplete(dynamic action()) Future<Null>
Registers a function to be called when this future completes. [...]
whenCompleteOrCancel(VoidCallback callback) → void
Calls callback either when this future resolves or when the ticker is canceled.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed. [...]
inherited

Operators

operator ==(other) bool
The equality operator. [...]
inherited