Referencia rápida

Chuleta del Ecosistema y Middleware de Awesome Redux

Una guia de referencia para el ecosistema Redux: estandar Flux Standard Action (FSA), middlewares asincronos (redux-thunk, redux-promise) y reducers.

· Publicado

Una guia de referencia de las librerias esenciales, creadores de acciones y middlewares asincronos del ecosistema Redux.

Creadores de Acciones y Utilidades

redux-actions

Genera creadores de acciones conformes con 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)

Estandar legible para objetos de accion en Flux con type, payload, error y meta opcional:

// 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

Permite despachar un array de acciones en una sola llamada a dispatch:

store.dispatch([
  { type: 'INCREMENT', payload: 1 },
  { type: 'NOTIFY', payload: 'Count updated' }
]);

reduce-reducers

Combina reducers secuenciales sin crear anidamientos de espacios de nombres:

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)
);

Middleware Asíncrono y Efectos Secundarios

redux-thunk

Permite escribir action creators que devuelven una funcion con acceso a dispatch y 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));

See: redux-thunk on GitHub


redux-promise

Middleware de promesas compatible con FSA que resuelve promesas en el payload antes de llegar a los reducers:

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

Registra transiciones de estado y acciones despachadas en la consola del navegador:

import { createLogger } from 'redux-logger';

const logger = createLogger({
  collapsed: true,
  diff: true
});

Referencias

Temas relacionados