SwitchIfEmptyStreamTransformer<T> class

When the original observable emits no items, this operator subscribes to the given fallback stream and emits items from that observable instead.

This can be particularly useful when consuming data from multiple sources. For example, when using the Repository Pattern. Assuming you have some data you need to load, you might want to start with the fastest access point and keep falling back to the slowest point. For example, first query an in-memory database, then a database on the file system, then a network call if the data isn't on the local machine.

This can be achieved quite simply with switchIfEmpty!


// Let's pretend we have some Data sources that complete without emitting
// any items if they don't contain the data we're looking for
Stream<Data> memory;
Stream<Data> disk;
Stream<Data> network;

// Start with memory, fallback to disk, then fallback to network.
// Simple as that!
Stream<Data> getThatData =


SwitchIfEmptyStreamTransformer(Stream<T> fallbackStream)


transformer → StreamTransformer<T, T>
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


bind(Stream<T> stream) → Stream<T>
Transforms the provided stream. [...]
cast<RS, RT>() → StreamTransformer<RS, RT>
Provides a StreamTransformer<RS, RT> view of this stream transformer.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed.
toString() → String
Returns a string representation of this object.


operator ==(dynamic other) → bool
The equality operator.