Referência rápida

Guia Rápido do Ecossistema e Middlewares do Awesome Redux

Um guia de referencia para o ecossistema Redux: padrao Flux Standard Action (FSA), middlewares assincronos (redux-thunk, redux-promise) e reducers.

· Publicado

Um guia selecionado das principais bibliotecas, criadores de acao e padroes de middleware assincrono no ecossistema Redux.

Criadores de Ações e Utilitários

redux-actions

Gera criadores de acoes em conformidade com o 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)

Um padrao legivel para acoes contendo type, payload, error e 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 disparar um array de acoes em uma unica chamada de dispatch:

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

reduce-reducers

Combina reducers sequenciais sem aninhar namespaces:

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 Assíncronos e Efeitos Colaterais

redux-thunk

Permite que criadores de acao retornem funcoes com acesso a dispatch e 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 compativel com FSA que resolve promises em payload antes de enviar aos 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 transicoes de estado e acoes disparadas no console do navegador:

import { createLogger } from 'redux-logger';

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

Referências

Temas relacionados