Un guide de reference selectionne pour les bibliotheques essentielles et les patrons de middleware asynchrones de Redux.
Créateurs d'Actions et Utilitaires
redux-actions
Cree des createurs d'actions conformes a Flux Standard Action (FSA) :
import { createAction } from 'redux-actions';
const increment = createAction('INCREMENT', amount => amount);
// increment(42) → { type: 'INCREMENT', payload: 42 }
// Automatically handles error objects:
const err = new Error('Network failure');
// increment(err) → { type: 'INCREMENT', payload: err, error: true }
See: redux-actions on npm
Flux Standard Action (FSA)
Un format standard clair pour les actions avec type, payload, error et meta optionnel :
// Success action
{
type: 'ADD_TODO',
payload: { text: 'Write documentation' }
}
// Error action
{
type: 'ADD_TODO',
payload: new Error('Failed to save'),
error: true
}
See: flux-standard-action on GitHub
redux-multi
Permet de dispatcher un tableau d'actions en un seul appel :
store.dispatch([
{ type: 'INCREMENT', payload: 1 },
{ type: 'NOTIFY', payload: 'Count updated' }
]);
reduce-reducers
Combine des reducers sequentiels sans imbrication d'espace de noms :
import reduceReducers from 'reduce-reducers';
const combined = reduceReducers(
(state, action) => (action.type === 'ADD' ? state + action.payload : state),
(state, action) => (action.type === 'MULTIPLY' ? state * action.payload : state)
);
Middlewares Asynchrones et Effets Secondaires
redux-thunk
Permet d'ecrire des createurs d'actions retournant une fonction avec acces a dispatch et getState :
const fetchUser = (id) => async (dispatch, getState) => {
dispatch({ type: 'FETCH_USER_REQUEST' });
try {
const res = await fetch(`/api/users/${id}`);
const data = await res.json();
dispatch({ type: 'FETCH_USER_SUCCESS', payload: data });
} catch (error) {
dispatch({ type: 'FETCH_USER_FAILURE', payload: error, error: true });
}
};
// Dispatch like a normal action:
store.dispatch(fetchUser(42));
redux-promise
Middleware de promesses compatible FSA resolvant automatiquement les promesses dans le payload :
import { createAction } from 'redux-actions';
const fetchPosts = createAction('FETCH_POSTS', async () => {
const response = await fetch('/api/posts');
return response.json();
});
// Resolves payload promise automatically:
store.dispatch(fetchPosts());
redux-logger
Journalise les transitions d'etat et les actions directement dans la console du navigateur :
import { createLogger } from 'redux-logger';
const logger = createLogger({
collapsed: true,
diff: true
});