@crossfield/redux-batched-actions
TypeScript icon, indicating that this package has built-in type declarations

0.1.6-0 • Public • Published

redux-batched-actions

Build Status

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

npm install --save redux-batched-actions

Usage

import {createStore} from 'redux';
import {batchActions, enableBatching} from 'redux-batched-actions';
import {createAction} from 'redux-actions';

const doThing = createAction('DO_THING')
const doOther = createAction('DO_OTHER')

function reducer(state, action) {
	switch (action.type) {
		case 'DO_THING': return 'thing'
		case 'DO_OTHER': return 'other'
		default: return state
	}
}

const store = createStore(enableBatching(reducer), initialState)

store.dispatch(batchActions([doThing(), doOther()]))
// OR
store.dispatch(batchActions([doThing(), doOther()], 'DO_BOTH'))

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:

const setLoading = createAction('SET_LOADING')
const setUser = createAction('SET_USER')
const unsetLoading = createAction('UNSET_LOADING')

function login(credentials) {
	return function(dispatch) {
		dispatch(setLoading());

		authenticate(credentials)
			.then(user => {
				dispatch(batchActions([
					setUser(user),
					unsetLoading()
				], 'LOGIN_SUCCESS'))
			})
		})
	}
}

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

Thanks

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

Dependencies (0)

    Dev Dependencies (7)

    Package Sidebar

    Install

    npm i @crossfield/redux-batched-actions

    Weekly Downloads

    0

    Version

    0.1.6-0

    License

    MIT

    Last publish

    Collaborators

    • crxssfield