redux-batched-actions

Batching action creator and associated higher order reducer for redux that enables batching subscriber notifications for an array of actions.

1npm install --save redux-batched-actions

Usage

1import {createStore, applyMiddleware} from 'redux';
2import {batchActions, enableBatching, batchDispatchMiddleware} from 'redux-batched-actions';
3import {createAction} from 'redux-actions';
4
5const doThing = createAction('DO_THING')
6const doOther = createAction('DO_OTHER')
7
8function reducer(state, action) {
9	switch (action.type) {
10		case 'DO_THING': return 'thing'
11		case 'DO_OTHER': return 'other'
12		default: return state
13	}
14}
15
16// Handle bundled actions in reducer
17const store = createStore(enableBatching(reducer), initialState)
18
19store.dispatch(batchActions([doThing(), doOther()]))
20// OR
21store.dispatch(batchActions([doThing(), doOther()], 'DO_BOTH'))
22

Recipes

Async

Usage for action creators that return objects is trivial, but it also works well with thunks to perform large reductions on multiple asynchronous actions, or actions that rely on external services. For example:

1const setLoading = createAction('SET_LOADING')
2const setUser = createAction('SET_USER')
3const unsetLoading = createAction('UNSET_LOADING')
4
5function login(credentials) {
6	return function(dispatch) {
7		dispatch(setLoading());
8
9		authenticate(credentials)
10			.then(user => {
11				dispatch(batchActions([
12					setUser(user),
13					unsetLoading()
14				], 'LOGIN_SUCCESS'))
15			})
16		})
17	}
18}

In this example, the subscribers would be notified twice: once when the state is loading, and then again once the user has been loaded.

Middleware integration

You can add a middleware to dispatch each of the bundled actions. This can be used if other middlewares are listening for one of the bundled actions to be dispatched.

1const store = createStore(
2		reducer,
3		initialState,
4		applyMiddleware(batchDispatchMiddleware)
5)

Note that batchDispatchMiddleware and enableBatching should not be used together as batchDispatchMiddleware calls next on the action it receives, whilst also dispatching each of the bundled actions.

Thanks

Thanks to Dan Abramov for help in Redux best practices and original idea.