AsyncStateNotifier<T> class
A ChangeNotifier that drives a single async operation and exposes its result as an AsyncState.
Manage any single async operation (e.g. an API call) without writing loading/error/data boilerplate yourself:
final notifier = AsyncStateNotifier<User>();
// Starts the operation; moves state through loading → data / error.
await notifier.run(() => userRepository.fetchProfile());
// Listen in the UI:
ListenableBuilder(
listenable: notifier,
builder: (_, __) => AsyncBuilder(
state: notifier.state,
data: (user) => Text(user.name),
),
);
- Inheritance
-
- Object
- ChangeNotifier
- AsyncStateNotifier
Constructors
Properties
- hashCode → int
-
The hash code for this object.
no setterinherited
- hasListeners → bool
-
Whether any listeners are currently registered.
no setterinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
-
state
→ AsyncState<
T> -
The current state of the async operation.
no setter
Methods
-
addListener(
VoidCallback listener) → void -
Register a closure to be called when the object changes.
inherited
-
dispose(
) → void -
Discards any resources used by the object. After this is called, the
object is not in a usable state and should be discarded (calls to
addListener will throw after the object is disposed).
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
notifyListeners(
) → void -
Call all the registered listeners.
inherited
-
refresh(
Future< T> operation()) → Future<void> -
Executes
operationwhile preserving the current value as visible data. -
removeListener(
VoidCallback listener) → void -
Remove a previously registered closure from the list of closures that are
notified when the object changes.
inherited
-
reset(
) → void - Resets the state back to AsyncLoading.
-
run(
Future< T> operation()) → Future<void> -
Executes
operation, transitioning through:loading → dataon success, orloading → erroron failure. -
setData(
T value) → void -
Directly sets the state to AsyncData with
value. -
setError(
Object error, [StackTrace? st]) → void -
Directly sets the state to AsyncError with
errorand optionalst. -
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited