Scenic City Summit 2017: Get Started with Redux

1.

Jeremy Fairbank @elpapapollo / jfairbank Get Started with Redux

2.

Software is broken. We are here to fix it. Say
hi@testdouble.com

3.

The Wild West of State

4.

<div data-id="42" data-name="Tucker"> ... </div> var $el = $('[data-id="42"]'); var
currentName = $el.data('name'); $el.data('name', currentName.toUpperCase()); Data in the DOM

5.

Controller View Model Model Model Model Model View View View
View MVC

6.

View Model Model Model Model Model View Model View Model
View Model View Model Model Two-way Data Binding

7.

The Wild West of State State is everywhere and anyone
can change it!

8.

Predictable State Container

9.

All application state in one place State Container

10.

Predictable Old State REDUCER New State

11.

Predictable Old State REDUCER New State • State changes in
one place

12.

one place • State changes in well-defined ways

13.

one place • State changes in well-defined ways • Changes are serialized

14.

Reducer View State Actions

15.


16.

Reducer View React, Angular, Vue, Vanilla JS, etc. State Actions

17.

Reducer View State Actions Dispatch

18.


19.

<button id="decrement">-</button> <div id="counter">0</div> <button id="increment">+</button>

20.

incrementBtn.addEventListener('click', () => { counter.innerText = Number(counter.innerText) + 1; });
decrementBtn.addEventListener('click', () => { counter.innerText = Number(counter.innerText) - 1; });

21.

let state = 0; function render() { counter.innerText = state;
} incrementBtn.addEventListener('click', () => { state += 1; render(); }); decrementBtn.addEventListener('click', () => { state -= 1; render(); });

22.


23.


24.


25.

state += 1; state -= 1; Anyone can access and
mutate state

26.

state += 1 state -= 1 { type: 'INCREMENT' }
{ type: 'DECREMENT' } Tokens/descriptors that describe a type of change. Actions

27.

function reducer(state = 0, action) { switch (action.type) { case
'INCREMENT': return state + 1; case 'DECREMENT': return state - 1; default: return state; } } Returns new state from current state and action. Reducer

28.


29.


30.


31.


32.


33.


34.

Updating state is just a function call now let state
= 0; state = reducer(state, { type: 'INCREMENT' }); // 1 state = reducer(state, { type: 'INCREMENT' }); // 2 state = reducer(state, { type: 'DECREMENT' }); // 1 state = reducer(state, { type: 'ADD_2' }); // 1 console.log(state); // 1

35.

Updating state is just a function call now let state
= 0; state = reducer(state, { type: 'INCREMENT' }); // 1 state = reducer(state, { type: 'INCREMENT' }); // 2 state = reducer(state, { type: 'DECREMENT' }); // 1 state = reducer(state, { type: 'ADD_2' }); // 1 console.log(state); // 1 Unhandled types are ignored

36.

function dispatch(action) { state = reducer(state, action); render(); } incrementBtn.addEventListener('click',
() => { dispatch({ type: 'INCREMENT' }); }); decrementBtn.addEventListener('click', () => { dispatch({ type: 'DECREMENT' }); }); Decouple event from state change.

37.


38.


39.


40.


41.

STORE

42.

import { createStore } from 'redux'; const store = createStore(reducer,
0); store.getState(); // 0

43.


44.


45.


46.


47.

incrementBtn.addEventListener('click', () => { store.dispatch({ type: 'INCREMENT' }); }); decrementBtn.addEventListener('click',
() => { store.dispatch({ type: 'DECREMENT' }); }); store.subscribe(() => { counter.innerText = store.getState(); });

48.


49.


50.

Store Reducer State View 0

51.

Store Reducer State View 0

52.

Store Reducer State View 0 getState

53.

Store Reducer View State 0

54.

Store Reducer View State 0 INCREMENT dispatch

55.

Store Reducer View State 0 INCREMENT dispatch

56.


57.


58.


59.

Store Reducer View State 1 1 subscribe getState

60.

() => { store.dispatch({ type: 'DECREMENT' }); }); Problems: • Creating actions are cumbersome • Requires direct access to store

61.

const increment = () => ({ type: 'INCREMENT', }); const
decrement = () => ({ type: 'DECREMENT', }); Reusable functions that create actions Action Creators

62.


63.


64.

incrementBtn.addEventListener('click', () => { store.dispatch(increment()); }); decrementBtn.addEventListener('click', () => {
store.dispatch(decrement()); }); Problems: • Creating actions are cumbersome • Requires direct access to store

65.

const actions = { increment: () => store.dispatch(increment()), decrement: ()
=> store.dispatch(decrement()), }; Automatically dispatch when invoked Bound Action Creators

66.

=> store.dispatch(decrement()), }; Automatically dispatch when invoked Bound Action Creators Manually created

67.

=> store.dispatch(decrement()), }; Automatically dispatch when invoked Bound Action Creators

68.

import { bindActionCreators } from 'redux'; const actions = bindActionCreators(
{ increment, decrement }, store.dispatch ); Automatically dispatch when invoked Bound Action Creators

69.

{ increment, decrement }, store.dispatch ); Automatically dispatch when invoked Bound Action Creators

70.

{ increment, decrement }, store.dispatch ); Automatically dispatch when invoked Bound Action Creators Automatically created

71.

Problems: • Creating actions are cumbersome • Requires direct access
to store incrementBtn.addEventListener('click', actions.increment); decrementBtn.addEventListener('click', actions.decrement);

72.

React +

73.

github.com/reactjs/react-redux npm install --save react-redux Official React bindings for Redux
React Redux Library

74.

Reducer State Actions React Redux

75.

React Redux React Application

76.

React Redux React Application Provider

77.

Component React Redux React Application Provider connect State Action Creators

78.

Component Child React Redux React Application Provider connect State Child
Action Creators

79.

const MyApp = () => ( <div> <button>-</button> <div>0</div> <button>+</button>
</div> );

80.

import React from 'react'; import { render } from 'react-dom';
import { Provider } from 'react-redux'; render(( <Provider store={store}> <MyAppContainer /> </Provider> ), document.getElementById('main'));

81.


82.


83.

import { connect } from 'react-redux'; const mapStateToProps = counter
=> ({ counter }); function mapDispatchToProps(dispatch) { return bindActionCreators({ onIncrement: increment, onDecrement: decrement, }, dispatch); } const MyAppContainer = connect( mapStateToProps, mapDispatchToProps )(MyApp);

84.


85.


86.


87.


88.

const MyApp = (props) => ( <div> <button onClick={props.onDecrement}> -
</button> <div>{props.counter}</div> <button onClick={props.onIncrement}> + </button> </div> );

89.

</button> <div>{props.counter}</div> <button onClick={props.onIncrement}> + </button> </div> ); Store state mapStateToProps

90.

</button> <div>{props.counter}</div> <button onClick={props.onIncrement}> + </button> </div> ); Bound action creators mapDispatchToProps

91.

Immutable Object State

92.

const initialState = { counter: 0, car: { color: 'red',
}, };

93.

}, };

94.

}, };

95.

decrement = () => ({ type: 'DECREMENT', }); const changeColor = color => ({ type: 'CHANGE_COLOR', payload: color, });

96.


97.


98.

function reducer(state = initialState, action) { switch (action.type) { case
'INCREMENT': return { ...state, counter: state.counter + 1 }; case 'DECREMENT': return { ...state, counter: state.counter - 1 }; case 'CHANGE_COLOR': return { ...state, car: { color: action.payload } }; default: return state; } }

99.


100.


101.


102.


103.


104.

store.subscribe(() => { console.log('state =', store.getState()); }); store.dispatch(increment()); store.dispatch(changeColor('green')); //
state = { counter: 1, car: { color: 'red' } } // state = { counter: 1, car: { color: 'green' } }

105.


106.


107.

function reducer(state = initialState, action) { }

108.

Reducer Composition Create modular reducers for better organization and readability

109.

Root Reducer Counter Reducer Car Reducer

110.

function counterReducer(state = 0, action) { switch (action.type) { case
'INCREMENT': return state + 1; case 'DECREMENT': return state - 1; default: return state; } }

111.

const initialState = { color: 'red' }; function carReducer(state =
initialState, action) { switch (action.type) { case 'CHANGE_COLOR': return { ...state, color: action.payload }; default: return state; } }

112.


113.


114.

function reducer(state = {}, action) { return { counter: counterReducer(state.counter,
action), car: carReducer(state.car, action), }; }

115.


116.


117.


118.

import { combineReducers } from 'redux'; const reducer = combineReducers({
counter: counterReducer, car: carReducer, });

119.


120.


121.

Root Reducer Counter Reducer Car Reducer Engine Reducer Tire Reducer
… … …

122.

… … …

123.

… … …

124.

Interact with APIs?

125.

Middleware Enhance Redux applications

126.

• Logging Middleware Enhance Redux applications

127.

• Logging • Debugging Middleware Enhance Redux applications

128.

• Logging • Debugging • API interaction Middleware Enhance Redux
applications

129.

• Logging • Debugging • API interaction • Custom actions
Middleware Enhance Redux applications

130.

Reducer View State Actions Middleware

131.

Reducer View State Actions Middleware Intercept

132.

const logMiddleware = api => next => action => {
console.log('dispatch', action); const result = next(action); console.log('state =', api.getState()); return result; };

133.


134.


135.


136.


137.


138.


139.


140.


141.

import { applyMiddleware } from 'redux'; const store = createStore(
reducer, applyMiddleware(logMiddleware) ); store.dispatch(increment()); store.dispatch(changeColor('green')); // dispatch { type: 'INCREMENT' } // state = { counter: 1, car: { color: 'red' } } // dispatch { type: 'CHANGE_COLOR', payload: 'green' } // state = { counter: 1, car: { color: 'green' } }

142.


143.


144.


145.


146.

const initialState = { users: [], isFetching: false, };

147.

'REQUEST_USERS': return { ...state, isFetching: true }; case 'RECEIVE_USERS': return { ...state, isFetching: false, users: action.payload, }; default: return state; } }

148.


149.


150.

const requestUsers = () => ({ type: 'REQUEST_USERS', }); const
receiveUsers = users => ({ type: 'RECEIVE_USERS', payload: users, });

151.

const thunkMiddleware = api => next => action => {
if (typeof action === 'function') { return action(api.dispatch); } return next(action); }; const store = createStore( reducer, applyMiddleware(thunkMiddleware) );

152.


153.


154.


155.

function fetchUsers() { return dispatch => { dispatch(requestUsers()); return axios.get('/users')
.then(({ data }) => { dispatch(receiveUsers(data)); }); }; } store.dispatch(fetchUsers());

156.

.then(({ data }) => { dispatch(receiveUsers(data)); }); }; } store.dispatch(fetchUsers()); Action Creator

157.

.then(({ data }) => { dispatch(receiveUsers(data)); }); }; } store.dispatch(fetchUsers()); Action

158.

.then(({ data }) => { dispatch(receiveUsers(data)); }); }; } store.dispatch(fetchUsers());

159.

Alternatives for async code.

160.

• Appropriate for more complex business logic and async flows.
Alternatives for async code.

161.

• Middleware-based like thunk middleware. Alternatives for async code.

162.

• Middleware-based like thunk middleware. • redux-saga Alternatives for async code.

163.

• Middleware-based like thunk middleware. • redux-saga • redux-observable Alternatives for async code.

164.

• Middleware-based like thunk middleware. • redux-saga • redux-observable • redux-logic Alternatives for async code.

165.

× ✓ Testing

166.

const state = { counter: 0, car: { color: 'red'
}, }; it('returns initial state', () => { expect(reducer(undefined, {})).toEqual(state); }); it('increments the number', () => { const subject = reducer(state, increment()).counter; expect(subject).toBe(1); }); it('changes the car color', () => { const subject = reducer(state, changeColor('green')).car.color; expect(subject).toBe('green'); }); Easy reducer unit tests!

167.

it('creates an INCREMENT action', () => { expect(increment()).toEqual({ type: 'INCREMENT'
}); }); it('creates a CHANGE_COLOR action', () => { expect(changeColor('blue')).toEqual({ type: 'CHANGE_COLOR', payload: 'blue', }); }); You can test action creators, but not really necessary.

168.

.then(({ data }) => { dispatch(receiveUsers(data)); }); }; } However, you should test async action creators.

169.

import td from 'testdouble'; const axios = td.replace('axios'); it('fetches users',
() => { // Arrange const dispatch = td.function(); td.when(axios.get('/users')).thenResolve({ data: 'success' }); // Act return fetchUsers()(dispatch).then(() => { const subject = td.matchers.captor(); td.verify(dispatch(subject.capture())); // Assert expect(subject.values[0]).toEqual(requestUsers()); expect(subject.values[1]).toEqual(receiveUsers('success')); }); }); Unit test with test doubles

170.

Use integration tests to ensure all pieces work together. Allow
store, reducer, and actions to all interact .

171.

it('fetches users', () => { // Arrange const store =
createStore(reducer, applyMiddleware(thunkMiddleware)); td.replace(axios, 'get'); td.when(axios.get('/users')).thenResolve({ data: 'success' }); // Act const promise = store.dispatch(fetchUsers()); const subject = store.getState; // Assert expect(subject()).toEqual({ isFetching: true, users: [] }); return promise.then(() => { expect(subject()).toEqual({ isFetching: false, users: 'success' }); }); });

172.


173.


174.


175.

Resources • Redux • redux.js.org • egghead.io/courses/getting-started-with- redux • React
• github.com/reactjs/react-redux

176.

Thanks! Slides: bit.ly/scs-redux Jeremy Fairbank @elpapapollo / jfairbank

Scenic City Summit 2017: Get Started with Redux

Scenic City Summit 2017: Get Started with Redux

Want more?

Transcript