All 7 Dart Streams & StreamControllers questions
More in Dart Streams & StreamControllers
What is a Stream in Dart, and how does it differ from a Future in terms of how many values it can actually provide over time? How does the listen method let you subscribe to a Stream and react each time it emits a new value? What is a StreamController, and how does it let you manually create and control your own custom Stream, pushing values into it yourself whenever you choose to? How do stream transformation methods, such as map, where, and distinct, let you process and filter the values emitted by a Stream, similar to how these same methods work on a regular Dart collection? How does the StreamBuilder widget in Flutter let you build a reactive user interface that automatically updates whenever a Stream emits a new value, without needing to manually manage the underlying subscription yourself? What are common StreamTransformer patterns, such as debounce and throttle, and how do they help control the actual rate at which a stream's events are processed, particularly for something like a rapidly typed search query?
Advertisement
Flutter › Dart Streams & StreamControllers

What is the difference between a single subscription stream and a broadcast stream in Dart, and when would you specifically need to use a broadcast stream instead?

Intermediate

Answer

A single subscription stream, which is the default type created by a regular StreamController, only allows exactly one single listener to ever subscribe to it over its entire lifetime, and attempting to add a second separate listener throws an error, whereas a broadcast stream, created by passing the broadcast parameter, allows multiple entirely separate listeners to all subscribe to and independently receive the exact same stream of events simultaneously, which is necessary whenever more than one distinct part of your application genuinely needs to react to the very same underlying stream of events at the same time.
final controller = StreamController<String>.broadcast();

controller.stream.listen((value) => print('Listener 1: $value'));
controller.stream.listen((value) => print('Listener 2: $value'));
Real-world example A shared notification service uses a broadcast StreamController so that both the main notification badge indicator and a separate dedicated notifications screen can each independently listen to and react to the exact same underlying stream of incoming notification events.

Common follow-ups: What error occurs if you try to add a second listener to a non broadcast stream?;Can a single subscription stream ever be converted into a broadcast stream afterward?

State Management with BLoC & Cubit;State Management with Provider
All 7 Dart Streams & StreamControllers questions