Supported Assertion Frameworks/Libraries:

What it does:

Allows to avoid retesting nested action creators

functionactionA(){returndispatch=>{dispatch(actionAStart());returnapi.getA().then(response=>{dispatch(actionAFinish(response));dispatch(actionB());}).catch(err=>{dispatch(actionAFailure(err));});};}functionactionB(){returndispatch=>{dispatch(actionBStart());returnapi.getB().then(response=>{dispatch(actionBFinish(response));}).catch(err=>{dispatch(actionBFailure(err));});};}

constexpectedActions=[{type:action_a_start},{type:action_a_success},{type:action_b_start},// retesting of action B{type:action_b_success}// retesting of action B];conststore=mockStore({todos:[]});store.dispatch(actionA()).then(()=>{expect(store.getActions()).toEqual(expectedActions);}).then(done).catch(done);

expect(actionA()).withState({todos:[]}).toDispatch([{type:action_a_start},{type:action_a_success},actionB()// just executing tested action],done);

Reduces repetitive code of test methods

conststore=mockStore(/* initial state */);constexpectedActions=[{type:types.FETCH_TODOS_REQUEST},/* All expected triggered action objects */];store.dispatch(fetchData()).then(()=>{constactions=store.getActions();expect(actions).toEqual(expectedActions);}).then(done).catch(done);

constexpectedActions=[/*All expected triggered action objects or action creator functions*/];expect(fetchData()).toDispatchActions(expectedActions,done);

expect(fetchData()).withState({/*custom state*/}).toDispatchActions(expectedActions,done);

Simplifies initial setup

constmiddlewares=[thunk];constmockStore=configureStore(middlewares);conststore=mockStore({/*initialstoreobject*});

registerMiddlewares([thunk]);// to set custom initial stateregisterInitialStoreState(/*object of function*/);// to generate initial state of your applicationregisterInitialStoreState(buildInitialStoreState(/*your root reducer*/));

Installation

$ npm install --save-dev redux-actions-assertions

Redux middlewares registration

// using ES6 modulesimport{registerMiddlewares}from'redux-actions-assertions';// using CommonJS modulesvarregisterMiddlewares=require('redux-actions-assertions').registerMiddlewares;// registrationregisterMiddlewares([/* Here you need to list your middlewares */]);

Default initial store state registration

// using ES6 modulesimport{registerInitialStoreState}from'redux-actions-assertions';// using CommonJS modulesvarregisterInitialStoreState=require('redux-actions-assertions').registerInitialStoreState;// registrationregisterInitialStoreState(/* default initial state object or function */);

// using ES6 modulesimport{buildInitialStoreState,registerInitialStoreState}from'redux-actions-assertions';// using CommonJS modulesvarreduxActionsAssertions=require('redux-actions-assertions');varregisterInitialStoreState=reduxActionsAssertions.registerInitialStoreState;// registrationregisterInitialStoreState(buildInitialStoreState(/* root reducer function */));