async_redux 22.0.0 async_redux: ^22.0.0 copied to clipboard
Redux state management. An optimized Redux version, which is very easy to learn and use, yet powerful and tailored for Flutter. It allows both sync and async reducers.
Please visit an Async Redux App Example Repository in GitHub for a full-fledged example with a complete app showcasing the fundamentals and best practices described in the AsyncRedux README.md file.
22.0.0 #
-
When you dispatch an async action, you can now use
var isWaiting = store.isWaitingFor(MyAction)
to check if the action is currently being processed. You can then use this boolean to show a loading spinner in your widget, for example. Note you can also check for specific actions, or any type from a list of action types. See the Show Spinner Example. -
Some features of the
async_redux
package are now available in a standalone Dart-only core package: https://pub.dev/packages/async_redux_core. You may use that core package when you are developing a Dart server (backend) with Celest, or when developing your own Dart-only package that does not depend on Flutter. Note: For the moment, the core package simply contains theUserException
, and nothing more. If you now importasync_redux_core
in your Celest server code and throw aUserException
there, the exception message will automatically be shown in a dialog to the user in your client app (if you use theUserExceptionDialog
feature).For Flutter applications nothing changes. You don't need to import the core package directly. You should continue to use this async_redux package, which already exports the code that's now in the core package.
-
BREAKING CHANGE: The
UserException
class was modified so that it was possible to move it to theasync_redux_core
. If your use ofUserException
was limited to specifying the error message, then you don't need to change anything:throw UserException('Error message')
will continue to work as before. However, for other more advanced features you will have to read theUserException
documentation and adapt. In the new public API ofUserException
you can now specify amessage
,reason
andcode
in the constructor, and then you can use methodsaddCallbacks
,addCause
andaddProps
to add more information:throw UserException('Invalid number', reason: 'Must be less than 42') .addCallbacks(onOk: () => print('OK'), onCancel: () => print('CANCEL')) .addCause(FormatException('Invalid input')) .addProps({'number': 42}));
Note the
code
parameter can only be a number now. If you were using a different type, for example enums, you can now include it in the props, like so:throw UserException('').addProps({'code': myError.invalidInput}).
or you can even create an extension method which allows you to writethrow UserException('').withCode(myError.invalidInput).
However, please read the newUserException
documentation to learn about the recommended way to usecode
to define the text of the error messages, and even easily translate them to the user language by using the i18n_extension translations package. -
BREAKING CHANGE:
StoreProvider.of
was removed. You can now access the store inside of widgets, and have your widgets rebuild when the state changes, by usingStoreProvider.state
andStoreProvider.dispatch
etc. This is only useful when you want to access the storestate
,dispatch
and wait for actions directly inside your widgets, instead of using theStoreConnector
(dumb widget / smart widget pattern). For example:// Read state (will rebuild when the state changes) var myInfo = StoreProvider.state<AppState>(context).myInfo; // Dispatch action StoreProvider.dispatch<AppState>(context, MyAction()); // Use isWaiting to show a spinner. var isWaiting = StoreProvider.isWaitingFor(<AppState>(context, MyAction);
However, to use this you should instead define these extension methods in your own code (supposing your state class is called
AppState
):extension BuildContextExtension on BuildContext { AppState get state => StoreProvider.state<AppState>(this); FutureOr<ActionStatus> dispatch(ReduxAction<AppState> action, {bool notify = true}) => StoreProvider.dispatch(this, action, notify: notify); Future<ActionStatus> dispatchAndWait(ReduxAction<AppState> action, {bool notify = true}) => StoreProvider.dispatchAndWait(this, action, notify: notify); ActionStatus dispatchSync(ReduxAction<AppState> action, {bool notify = true}) => StoreProvider.dispatchSync(this, action, notify: notify); bool isWaitingFor(Object actionOrTypeOrList) => StoreProvider.isWaitingFor<AppState>(this, actionOrTypeOrList); }
Which allow you to write it like this:
// Read state (will rebuild when the state changes) var myInfo = context.state.myInfo; // Dispatch action context.dispatch(MyAction()); // Use isWaiting to show a spinner. var isWaiting = context.isWaitingFor(MyAction);
Or, if you want a fully documented version, copy the file (build_context_extension), rename it with a
.dart
extension and put it in a visible location in your own code.See the: Connector vc Provider Example.
-
DEPRECATION WARNING: While the
StoreTester
is a powerful tool with advanced features that are beneficial for the most complex testing scenarios, for almost all tests it's now recommended to use theStore
directly. This approach involves waiting for an action to complete its dispatch process or for the store state to meet a certain condition. After this, you can verify the current state or action using the new methodsstore.dispatchAndWait
,store.waitCondition
,store.waitActionType
, andstore.waitAnyActionType
. For example:// Wait for some action to dispatch and check the state. await store.dispatchAndWait(MyAction()); expect(store.state.name, 'John') // Wait for some action to dispatch, and check for errors in the action status. var status = await dispatchAndWait(MyAction()); expect(status.originalError, isA<UserException>()); // Wait for some state condition expect(store.state.name, 'John') dispatch(ChangeNameAction("Bill")); var action = await store.waitCondition((state) => state.name == "Bill"); expect(action, isA<ChangeNameAction>()); expect(store.state.name, 'Bill'); // Wait until some action of a given type is dispatched. dispatch(DoALotOfStuffAction()); var action = store.waitActionType(ChangeNameAction); expect(action, isA<ChangeNameAction>()); expect(action.status.isCompleteOk, isTrue); expect(store.state.name, 'Bill'); // Wait until some action of any of the given types is dispatched. dispatch(BuyAction('IBM')); var action = store.waitAnyActionType([BuyAction, SellAction]); expect(store.state.portfolio.contains('IBM'), isTrue);
Note the
StoreTester
will NOT be removed, now or in the future. It's just not the recommended way to test the store anymore. -
To test the view-model generated by a
VmFactory
, you can now use the static methodVm.createFrom(store, factory)
. The method will return the view-model, which you can use to inspect the view-model properties directly, or call any of the view-model callbacks. Example:var store = Store(initialState: User("Mary")); var vm = Vm.createFrom(store, MyFactory()); // Checking a view-model property. expect(vm.user.name, "Mary"); // Calling a view-model callback and waiting for the action to finish. vm.onChangeNameTo("Bill"); // Dispatches SetNameAction("Bill"). await store.waitActionType(SetNameAction); expect(store.state.name, "Bill"); // Calling a view-model callback and waiting for the state to change. vm.onChangeNameTo("Bill"); // Dispatches SetNameAction("Bill"). await store.waitCondition((state) => state.name == "Bill"); expect(store.state.name, "Bill");
-
BREAKING CHANGE:
StoreConnector.model
was removed, after being deprecated for a long time. Please, use thevm
parameter instead. See classesVmFactory
andVm
. -
BREAKING CHANGE:
ReduxAction.reduceWithState()
was removed, after being deprecated for a long time.
21.7.1 #
-
DEPRECATION WARNING:
- Replace
action.isFinished
withaction.status.isCompletedOk
- Replace
action.status.isBeforeDone
withaction.status.hasFinishedMethodBefore
- Replace
action.status.isReduceDone
withaction.status.hasFinishedMethodReduce
- Replace
action.status.isAfterDone
withaction.status.hasFinishedMethodAfter
- Replace
action.status.isFinished
withaction.status.isCompletedOk
- Replace
-
The
action.status
now has a few more values:isCompleted
if the action has completed executing, either with or without errors.isCompletedOk
if the action has completed with no errors.isCompletedFailed
if the action has completed with errors.originalError
Holds the error thrown by the action's before/reduce methods, if any.wrappedError
Holds the error thrown by the action, after it was processed by the action'swrapError
and theglobalWrapError
.
21.6.0 #
-
DEPRECATION WARNING: The
wrapError
parameter of theStore
constructor is now deprecated in favor of theglobalWrapError
parameter. The reason for this deprecation is that the newGlobalWrapError
works in the same way as the action'sReduxAction.wrapError
, whileWrapError
does not. The difference is that whenWrapError
returnsnull
, the original error is not modified, while withGlobalWrapError
returningnull
will instead disable the error. In other words, where your oldWrapError
returnednull
, your newGlobalWrapError
should return the originalerror
:// WrapError (deprecated): Object? wrap(error, stackTrace, action) { if (error is MyException) return null; // Keep the error unaltered. else return processError(error); } // GlobalWrapError: Object? wrap( error, stackTrace, action) { if (error is MyException) return error; // Keep the error unaltered. else return processError(error); }
Also note,
GlobalWrapError
is more powerful because it can disable the error, whereasWrapError
cannot. -
Throwing an error in the action's
wrapError
or in theGlobalWrapError
was disallowed (you needed to make sure it never happened). Now, it's allowed. If instead of RETURNING an error you THROW an error inside these wrappers, AsyncRedux will catch it and use it instead the original error. In other words, returning an error or throwing an error from inside the wrappers now has the same effect. However, it is still recommended to return the error rather than throwing it.
21.5.0 #
- DEPRECATION WARNING: Method
dispatchAsync
was renamed todispatchAndWait
. The old name is still available, but deprecated and will be removed. The new name is more descriptive of what the method does, and the fact thatdispatchAndWait
can be used to dispatch both sync and async actions. The only difference betweendispatchAndWait
anddispatch
is thatdispatchAndWait
returns aFuture
which can be awaited to know when the action is finished.
21.1.1 #
await StoreTester.dispatchAndWait(action)
dispatches an action, and then waits until it finishes. This is the same as doing:storeTester.dispatch(action); await storeTester.wait(action);
.
21.0.2 #
- Flutter 3.16.0 compatible.
20.0.2 #
- Fixed
WrapReduce
(which may be used to wrap the reducer to allow for some pre- or post-processing) to avoid async reducers to be called twice.
20.0.0 #
- Flutter 3.10.0 and Dart 3.0.0
19.0.2 #
- Docs improvement.
19.0.1 #
-
Flutter 3.7.5, Dart 2.19.2, fast_immutable_collections: 9.0.0.
-
BREAKING CHANGE: The
Action.wrapError(error, stackTrace)
method now also gets the stacktrace instead of just the error. If your code breaks, just add the extra parameter, like so:Object wrapError(error) => ...
turns intoObject wrapError(error, _) => ...
- BREAKING CHANGE: When a
Persistor
is provided to the Store, it now considers theinitialState
is already persisted. Before this change, it considered nothing was persisted. Note: Before you create the store, you are allowed to call thePersistor
methods directly:Persistor.saveInitialState()
,readState()
anddeleteState()
. However, after you create the store, please don't call those methods yourself anymore. If you do it, AsyncRedux cannot keep track of which state was persisted. After store creation, if necessary, you should use the corresponding methodsStore.saveInitialStateInPersistence()
,Store.readStateFromPersistence()
andStore.deleteStateFromPersistence()
. These methods let AsyncRedux keep track of the persisted state, so that it's able to callPersistor.persistDifference()
with the appropriate parameters.
- Method
Store.getLastPersistedStateFromPersistor()
returns the state that was last persisted to the local persistence. It's unlikely you will use this method yourself.
-
BREAKING CHANGE: The factory declaration used to have two type parameters, but now it has three:
class Factory extends VmFactory<AppState, MyConnector, MyViewModel>
With that change, you can now reference the view-model inside the Factory methods, by using thevm
getter. Example:ViewModel fromStore() => ViewModel( value: _calculateValue(), onTap: _onTap); } void _onTap() => dispatch(SaveValueAction(vm.value)); // Use the value from the vm.
Note 1: You can only use the
vm
getter after thefromStore()
method is called, which means you cannot reference thevm
inside of thefromStore()
method itself. If you do that, you'll get aStoreException
. You also cannot use thevm
getter if the view-model is null.Note 2: To reduce boilerplate, and not having to pass the
AppState
type parameter whenever you create a Factory, I recommend you define a base Factory, like so:abstract class BaseFactory<T extends Widget?, Model extends Vm> extends VmFactory<AppState, T, Model> { BaseFactory([T? connector]) : super(connector); }
-
Added class LocalJsonPersist to help persist the state as pure Json.
18.0.2 #
- Fixed small bug when persistor is paused before being used once.
18.0.0 #
- Version bump of dependencies.
17.0.1 #
- Fixed issue with the StoreConnector.shouldUpdateModel method when the widget updates.
17.0.0 #
-
The
StateObserver.observe()
method signature changed to include anerror
parameter:void observe( ReduxAction<St> action, St stateIni, St stateEnd, Object? error, int dispatchCount, );
The state-observers are now also called when the action reducer complete with a error. In this case, the
error
object will not be null. This makes it easier to use state-observers for metrics. Please, see the documentation for the recommended clean-code way to do this.
16.1.0 #
- Added another cache function, for 2 states and 3 parameters:
cache2states_3params
.
16.0.0 #
-
BREAKING CHANGE: Async
reduce()
methods (those that return Futures) are now called synchronously (in the same microtask of their dispatch), just like a regular async function is. In other words, now dispatching a sync action works just the same as calling a sync function, and dispatching an async action works just the same as calling an async function.// Example: The below code will print: "BEFORE a1 f1 AFTER a2 f2" print('BEFORE'); dispatch(MyAsyncAction()); asyncFunction(); print('AFTER'); class MyAsyncAction extends ReduxAction<AppState> { Future<AppState?> reduce() async { print('a1'); await microtask; print('a2'); return state; } } Future<void> asyncFunction() async { print('f1'); await Future.microtask((){}); print('f2'); }
Before version
16.0.0
, thereduce()
method was called in a later microtask. Please note, the asyncreduce()
methods continue to return and apply the state in a later microtask (this did not change).The above breaking change is unlikely to affect you in any way, but if you want the old behavior, just add
await microtask;
to the first line of yourreduce()
method.
-
BREAKING CHANGE: When your reducer is async (i.e., returns
Future<AppState>
) you must make sure you do not return a completed future, meaning all execution paths of the reducer must pass through at least oneawait
keyword. In other words, don't return a Future if you don't need it. If your reducer has noawait
s, you must returnAppState?
instead ofFuture<AppState?>
, or addawait microtask;
to the start of your reducer, or returnnull
. For example:// These are right: AppState? reduce() { return state; } AppState? reduce() { someFunc(); return state; } Future<AppState?> reduce() async { await someFuture(); return state; } Future<AppState?> reduce() async { await microtask; return state; } Future<AppState?> reduce() async { if (state.someBool) return await calculation(); return null; } // But these are wrong: Future<AppState?> reduce() async { return state; } Future<AppState?> reduce() async { someFunc(); return state; } Future<AppState?> reduce() async { if (state.someBool) return await calculation(); return state; }
If you don't follow this rule, AsyncRedux may seem to work ok, but will eventually misbehave.
It's generally easy to make sure you are not returning a completed future. In the rare case your reducer function is very complex, and you are unsure that all code paths pass through an
await
, just addassertUncompletedFuture();
at the very END of yourreduce
method, right before thereturn
. If you do that, an error will be shown in the console if thereduce
method ever returns a completed future.If you're an advanced user interested in the details, check the sync/async tests.
-
When the
Event
class was created, Flutter did not have another class with that name. Now there is. For this reason, a typedef now allows you to useEvt
instead. If you need, you can hide one of them, by importing AsyncRedux like this:import 'package:async_redux/async_redux.dart' hide Event;
or
import 'package:async_redux/async_redux.dart' hide Evt;
15.0.0 #
- Flutter 3.0 support.
14.1.4 #
NavigateAction.popUntilRouteName()
can print the routes (for debugging).
14.1.2 #
- Better stacktrace for wrapped errors in actions.
14.1.1 #
-
The store persistor can now be paused and resumed, with methods
store.pausePersistor()
,store.persistAndPausePersistor()
andstore.resumePersistor()
. This may be used together with the app lifecycle, to prevent a persistence process to start when the app is being shut down. For example:child: StoreProvider<AppState>( store: store, child: AppLifecycleManager( // Add this widget here to capture lifecycle events. child: MaterialApp( ... class AppLifecycleManager extends StatefulWidget { final Widget child; const AppLifecycleManager({Key? key, required this.child}) : super(key: key); _AppLifecycleManagerState createState() => _AppLifecycleManagerState(); } class _AppLifecycleManagerState extends State<AppLifecycleManager> with WidgetsBindingObserver { void initState() { super.initState(); WidgetsBinding.instance.addObserver(this); } void dispose() { WidgetsBinding.instance.removeObserver(this); super.dispose(); } void didChangeAppLifecycleState(AppLifecycleState lifecycle) { store.dispatch(ProcessLifecycleChange_Action(lifecycle)); } Widget build(BuildContext context) => widget.child; } class ProcessLifecycleChangeAction extends ReduxAction<AppState> { final AppLifecycleState lifecycle; ProcessLifecycleChangeAction(this.lifecycle); @override Future<AppState?> reduce() async { if (lifecycle == AppLifecycleState.resumed || lifecycle == AppLifecycleState.inactive) { store.resumePersistor(); } else if (lifecycle == AppLifecycleState.paused || lifecycle == AppLifecycleState.detached) { store.persistAndPausePersistor(); } else throw AssertionError(lifecycle); return null; } }
-
When logging out of the app, you can call
store.deletePersistedState()
to ask the persistor to delete the state from disk. -
BREAKING CHANGE: This is a very minor change, unlikely to affect you. The signature for the
Action.wrapError
method has changed fromObject? wrapError(error)
toObject? wrapError(Object error)
. If you get an error when you upgrade, you can fix it by changing the method that broke intoObject? wrapError(dynamic error)
. -
BREAKING CHANGE: Context is now nullable for these StoreConnector methods:
void onInitialBuildCallback(BuildContext? context, Store<St> store, Model viewModel); void onDidChangeCallback(BuildContext? context, Store<St> store, Model viewModel); void onWillChangeCallback(BuildContext? context, Store<St> store, Model previousVm, Model newVm);
13.3.1 #
- Version bump of dependencies.
13.2.2 #
- Version bump of dependencies.
13.2.1 #
- Fixed
MockStore.dispatchAsync()
andMockStore.dispatchSync()
methods. Note:dispatchAsync
was later renamed todispatchAndWait
.
13.2.0 #
delay
parameter forWaitAction.add()
andWaitAction.remove()
methods.
13.1.0 #
- Added missing
dispatchSync
anddispatchAsync
toStoreTester
. Note:dispatchAsync
was later renamed todispatchAndWait
.
13.0.6 #
- Added missing
dispatchSync
toVmFactory
.
13.0.5 #
-
Sometimes, the store state is such that it's not possible to create a view-model. In those cases, the
fromStore()
method in theFactory
can now return anull
view-model. In that case, thebuilder()
method in theStoreConnector
can detect that the view-model isnull
, and then return some widget that does not depend on the view-model. For example:return StoreConnector<AppState, ViewModel?>( vm: () => Factory(this), builder: (BuildContext context, ViewModel? vm) { return (vm == null) ? Text("The user is not logged in") : MyHomePage(user: vm.user) ... class Factory extends VmFactory<AppState, MyHomePageConnector, ViewModel> { ViewModel? fromStore() { return (store.state.user == null) ? null : ViewModel(user: store.state.user) ... class ViewModel extends Vm { final User user; ViewModel({required this.user}) : super(equals: [user]);
13.0.4 #
-
dispatch
can be used to dispatch both sync and async actions. It returns aFutureOr
. You can await the result or not, as desired. -
dispatchAsync
can also be used to dispatch both sync and async actions. But it always returns aFuture
(not aFutureOr
). Use this only when you explicitly need aFuture
, for example, when working with theRefreshIndicator
widget. Note:dispatchAsync
was later renamed todispatchAndWait
. -
dispatchSync
allows you to dispatch SYNC actions only. In that case,dispatchSync(action)
is exactly the same asdispatch(action)
. However, if your action is ASYNC,dispatchSync
will throw an error. Use this only when you need to make sure an action is sync (meaning it impacts the store state immediately when it returns). This is not very common. Important: An action is sync if and only if both itsbefore
andreduce
methods are sync. If any or both these methods return a Future, then the action is async and will throw an error when used withdispatchSync
. -
StoreTester.getConnectorTester
helps testStoreConnector
s methods, such asonInit
,onDispose
andonWillChange
. For example, suppose you have aStoreConnector
which dispatchesSomeAction
on itsonInit
. You could test it like this:class MyConnector extends StatelessWidget { Widget build(BuildContext context) => StoreConnector<AppState, Vm>( vm: () => _Factory(), onInit: _onInit, builder: (context, vm) { ... } } void _onInit(Store<AppState> store) => store.dispatch(SomeAction()); } var storeTester = StoreTester(...); var connectorTester = storeTester.getConnectorTester(MyConnector()); connectorTester.runOnInit(); var info = await tester.waitUntil(SomeAction);
For more information, see section Testing the StoreConnector in the README.md file.
-
Fix:
UserExceptionDialog
now shows allUserException
s. It was discarding some of them under some circumstances, in a regression created in version 4.0.4. -
In the
Store
constructor you can now setmaxErrorsQueued
to control the maximum number of errors theUserExceptionDialog
error-queue can hold. Default is10
. -
ConsoleActionObserver
is now provided to print action details to the console. -
WaitAction.toString()
now returns a better description.
12.0.4 #
-
NavigateAction.toString()
now returns a better description, likeAction NavigateAction.pop()
. -
Fixed
NavigateAction.popUntilRouteName
andNavigateAction.pushNamedAndRemoveAll
to return the correct.type
. -
Added section
Dependency Injection
in README.md.
12.0.3 #
-
Improved error messages when the reducer returns an invalid type.
-
New
StoreTester
methods:waitUntilAll()
andwaitUntilAllGetLast()
. -
Passing an environment to the store, to help with dependency injection:
Store(environment: ...)
12.0.0 #
-
BREAKING CHANGE: Improved state typing for some
Store
parameters. You will now have to usePersistor<AppState>
instead ofPersistor
, andWrapError<AppState>
instead ofWrapError
etc. -
Global
Store(wrapReduce: ...)
. You may now globally wrap the reducer to allow for some pre or post-processing. Note: if the action also have a wrapReduce method, this global wrapper will be called AFTER (it will wrap the action's wrapper which wraps the action's reducer). -
Downgraded dev_dependencies
test: ^1.16.0
11.0.1 #
- You can now provide callbacks
onOk
andonCancel
to anUserException
. This allows you to dispatch actions when the user dismisses the error dialog. When using the defaultUserExceptionDialog
: (i) if onlyonOk
is provided, it will be called when the dialog is dismissed, no matter how. (ii) If bothonOk
andonCancel
are provided, thenonOk
will be called only when the OK button is pressed, whileonCancel
will be called when the dialog is dismissed by any other means.
11.0.0 #
-
BREAKING CHANGE: The
dispatchFuture
function is not necessary anymore. Just rename it todispatch
, since now thedispatch
function always returns a future, and you can await it or not, as desired. -
BREAKING CHANGE:
ReduxAction.hasFinished()
has been deprecated. It should be renamed toisFinished
. -
The
dispatch
function now returns anActionStatus
. Usually you will discard this info, but you may use it to know if the action completed with no errors. For example, suppose aSaveAction
looks like this:class SaveAction extends ReduxAction<AppState> { Future<AppState> reduce() async { bool isSaved = await saveMyInfo(); if (!isSaved) throw UserException("Save failed."); ... } }
Then, when you save some info, you want to leave the current screen if and only if the save process succeeded:
var status = await dispatch(SaveAction(info)); if (status.isFinished) dispatch(NavigateAction.pop()); // Or: Navigator.pop(context)
10.0.1 #
-
BREAKING CHANGE: The new
UserExceptionDialog.useLocalContext
parameter now allows theUserExceptionDialog
to be put in thebuilder
parameter of theMaterialApp
widget. Even if you use this dialog, it is unlikely this will be a breaking change for you. But if it is, and your error dialog now has problems, simply makeuseLocalContext: true
to return to the old behavior. -
BREAKING CHANGE:
StoreConnector
parametersonInitialBuild
,onDidChange
andonWillChange
now also get the context and the store. For example, where you previously hadonInitialBuild(vm) {...}
now you haveonInitialBuild(context, store, vm) {...}
.
9.0.9 #
- LocalPersist
saveJson()
andloadJson()
methods.
9.0.8 #
- FIC and weak-map version bump.
9.0.7 #
- NNBD improvements.
- FIC version bump.
9.0.1 #
- Downgrade to file: ^6.0.0 to improve compatibility.
9.0.0 #
- Nullsafe.
8.0.0 #
-
Uses nullsafe dependencies (it's not yet itself nullsafe).
-
BREAKING CHANGE: Cache functions (for memoization) have been renamed and extended.
7.0.2 #
- LocalPersist: Better handling of mock file-systems.
7.0.1 #
-
BREAKING CHANGE:
Now the
vm
parameter in theStoreConnector
is a function that creates aVmFactory
(instead of being aVmFactory
object itself).So, to upgrade, you just need to provide this:
vm: () => MyFactory(this),
Instead of this:
// Deprecated. vm: MyFactory(this),
Now the
StoreConnector
will create aVmFactory
every time it needs a view-model. The Factory will have access to:-
state
getter: The state the store was holding when the factory and the view-model were created. This state is final inside the factory. -
currentState()
method: The current (most recent) store state. This will return the current state the store holds at the time the method is called.
-
-
New store parameter
immutableCollectionEquality
lets you override the equality used for immutable collections from the fast_immutable_collections package.
6.0.3 #
- StoreTester.dispatchState().
6.0.2 #
- VmFactory.getAndRemoveFirstError().
6.0.1 #
NavigateAction
now closely follows theNavigator
api:push()
,pop()
,popAndPushNamed()
,pushNamed()
,pushReplacement()
,pushAndRemoveUntil()
,replace()
,replaceRouteBelow()
,pushReplacementNamed()
,pushNamedAndRemoveUntil()
,pushNamedAndRemoveAll()
,popUntil()
,removeRoute()
,removeRouteBelow()
,popUntilRouteName()
andpopUntilRoute()
.
1.0.0 #
- Initial commit: 2019/Aug05