ProviderContainer class
An object that stores the state of the providers and allows overriding the behavior of a specific provider.
If you are using Flutter, you do not need to care about this object
(outside of testing), as it is implicitly created for you by ProviderScope
.
- Annotations
-
- @sealed
Constructors
-
ProviderContainer({ProviderContainer? parent, List<
Override> overrides = const [], List<ProviderObserver> ? observers}) - An object that stores the state of the providers and allows overriding the behavior of a specific provider.
Properties
- debugCanModifyProviders ↔ void Function()?
-
A debug utility used by
flutter_riverpod
/hooks_riverpod
to check if it is safe to modify a provider.getter/setter pair -
debugChildren
→ List<
ProviderContainer> -
All the containers that have this container as
parent
.no setter - depth → int
-
How deep this ProviderContainer is in the graph of containers.
final
- hashCode → int
-
The hash code for this object.
no setterinherited
-
observers
→ List<
ProviderObserver> -
The list of observers attached to this container.
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- scheduler → ProviderScheduler
-
The object that handles when providers are refreshed and disposed.
latefinal
- vsync → void Function(void task())
-
A function that controls the refresh rate of providers.
no setter
- vsyncOverride ↔ void Function(void task())?
-
A way to override vsync, used by Flutter to synchronize a container
with the widget tree.
getter/setter pair
Methods
-
debugReassemble(
) → void - Executes ProviderElementBase.debugReassemble on all the providers.
-
dispose(
) → void - Release all the resources associated with this ProviderContainer.
-
exists(
ProviderBase< Object?> provider) → bool - Determines whether a provider is initialized or not.
-
getAllProviderElements(
) → Iterable< ProviderElementBase> - Traverse the ProviderElementBases associated with this ProviderContainer.
-
getAllProviderElementsInOrder(
) → Iterable< ProviderElementBase> - Visit all nodes of the graph at most once, from roots to leaves.
-
hasStateReaderFor(
ProviderListenable< Object?> provider) → bool - An internal utility for checking if a ProviderContainer has a fast path for reading a provider.
-
invalidate(
ProviderOrFamily provider) → void - Invalidates the state of the provider, destroying the state immediately and causing the provider to rebuild at some point in the future.
-
listen<
State> (ProviderListenable< State> provider, void listener(State? previous, State next), {bool fireImmediately = false, void onError(Object error, StackTrace stackTrace)?}) → ProviderSubscription<State> -
Listen to a provider and call
listener
whenever its value changes. -
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
pump(
) → Future< void> - Awaits for providers to rebuild/be disposed and for listeners to be notified.
-
read<
Result> (ProviderListenable< Result> provider) → Result - Reads a provider without listening to it and returns the currently exposed value.
-
readProviderElement<
State> (ProviderBase< State> provider) → ProviderElementBase<State> - Reads the state of a provider, potentially creating it in the process.
-
refresh<
State> (Refreshable< State> provider) → State - Forces a provider to re-evaluate its state immediately, and return the created value.
-
toString(
) → String -
A string representation of this object.
inherited
-
updateOverrides(
List< Override> overrides) → void - Updates the list of provider overrides.
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited