DevBlocObserver class

A BlocObserver that records every Bloc/Cubit state change for the App State Inspector. Set Bloc.observer = DevBlocObserver() before creating any Bloc/Cubit.

Constructors

DevBlocObserver()

Properties

hashCode → int

The hash code for this object.

no setter, inherited

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

Methods

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

onChange(BlocBase bloc, Change change) → void

Records the transition, then chains to the superclass.

onClose(BlocBase bloc) → void

Called whenever a Bloc is closed. onClose is called just before the Bloc is closed and indicates that the particular instance will no longer emit new states.

inherited

onCreate(BlocBase bloc) → void

Called whenever a Bloc is instantiated. In many cases, a cubit may be lazily instantiated and onCreate can be used to observe exactly when the cubit instance is created.

inherited

onDone(Bloc bloc, Object? event, [Object? error, StackTrace? stackTrace]) → void

Called whenever an event handler for a specific bloc has completed. This may include an error and stackTrace if an uncaught exception occurred within the event handler.

inherited

onError(BlocBase bloc, Object error, StackTrace stackTrace) → void

Called whenever an error is thrown in any Bloc or Cubit. The stackTrace argument may be StackTrace.empty if an error was received without a stack trace.

inherited

onEvent(Bloc bloc, Object? event) → void

Called whenever an event is added to any bloc with the given bloc and event.

inherited

onTransition(Bloc bloc, Transition transition) → void

Called whenever a transition occurs in any bloc with the given bloc and transition. A transition occurs when a new event is added and a new state is emitted from a corresponding EventHandler. onTransition is called before a bloc's state has been updated.

inherited

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited

Static Properties

entries → List<BlocStateEntry>

Recorded transitions, oldest first, capped at maxEntries.

no setter

version → ValueNotifier<int>

Bumped on every recorded change so the inspector can rebuild live.

final

Static Methods

clear() → void

Discards every recorded transition.

Constants

maxEntries → const int

Maximum transitions retained in memory. Oldest entries are dropped first, matching the behaviour of the other toolkit stores.