Starting simple
This is my first post here. I decided to share some of the knowledge I earned through making every mistake you can possibly make -.- Everything I write here I have learned by reading blog posts, trying to understand what was done and trial and error. If there are mistakes or if you think of a better way to do things, please let me know in the comments. I always appreciate helpful tips!
Now, first things first. You need to install React and Redux. I assume you know how to do that. After you've set up your React application you need to install a tool called redux-thunk by using the command npm install redux-thunk
With all those installed, we can now look at the components we're going to need to make the magic happen!
What is this thunk thing?
Basically a thunk is a function called by another function. Wait... What? Yeah, that's how I reacted the first time I heard this statement. Let me show you an example:
function some_function() {
// do something
return function thunk() {
// do something thunky later
}
}
So, some_function
is called, it does something and then it returns a new function with commands and possibly data for later execution.
Now what about Redux?
I don't want to go into the deepest depths of redux (most likely I couldn't anyway), so just a short explanation: It's a state container for javascript applications. It holds all the data you need for your application in one place. Every component within your application has its space in the state container where it looks for data. When the data changes, the component will change, too.
Actions
The idea is that you dispatch actions onto redux, and based on those actions the state is modified.
The funny thing is: An action doesn't do anything. It sounds like there is stuff going on, but there isn't. An action is just a plain object with a type
key. Like this one:
// this is an action
{
type: "SOME_ACTION",
payload: {}
}
Most of the time you don't want to write the same object over and over, so there is a concept called Action Creators.
Action Creators
Action Creators do exactly what they sound like, they create the action objects for you.
const SOME_ACTION = "SOME_ACTION";
function create_action(data) {
return {
type: SOME_ACTION,
payload: data
}
}
So with those action creators you can now easily use the SOME_ACTION
by calling create_action(data)
. Those action creators can be dispatched to redux by using dispatch(create_action(data))
.
Reducers
After an action is dispatched, it will be passed onto a so called reducer. A reducer is a function which is given a state and an action. Depending on the action it will transform the state and then return the new state.
function someReducer(state, action) {
switch(action.type) {
case SOME_ACTION:
return {
...state,
data: action.payload
}
break;
default:
// the dispatched action is not in this reducer, return the state unchanged
return state;
}
}
More complex applications most likely have multiple reducers, each one responsible for a single part of the state. So it is important to never forget the default case where the reducer returns the state unchanged.
Important to notice that reducers are pure functions. They never call something like an API or dispatch another action to redux.
You talked about thunks!?
You remembered that. Okay, thunks again. I just mentioned that reducers are pure. But often we want to have some kind of API call or dispatch something depending on data or whatever... But we can't... reducers are pure... Redux-Thunk to the rescue!
Redux-Thunk is pretty easy to understand. It is a so-called middleware for the redux store. It looks at every single action being dispatched and if it is a function, it calls the function. There is nothing more to it. But this opens up a whole new world of fancy "actions" which are dispatched to redux.
You might ask, how do I get this little wonder into my store?
import { applyMiddleware, createStore } from 'redux';
import thunk from 'redux-thunk';
import rootReducer from './rootReducer';
import initialState from './initialState';
const middlewares = [thunk];
createStore(rootReducer, initialState, applyMiddleware(...middlewares));
Let's get some products
We want to load some products from our API. To do this, we first set our component in some kind of pending state, we show a loading spinner or something like that. Then we load the data and we decide whether or not we can just show the product list or display some kind of error message-
We start with setting up our action creators.
// action.js
export const FETCH_PRODUCTS_PENDING = 'FETCH_PRODUCTS_PENDING';
export const FETCH_PRODUCTS_SUCCESS = 'FETCH_PRODUCTS_SUCCESS';
export const FETCH_PRODUCTS_ERROR = 'FETCH_PRODUCTS_ERROR';
function fetchProductsPending() {
return {
type: FETCH_PRODUCTS_PENDING
}
}
function fetchProductsSuccess(products) {
return {
type: FETCH_PRODUCTS_SUCCESS
products: products
}
}
function fetchProductsError(error) {
return {
type: FETCH_PRODUCTS_ERROR
error: error
}
}
Now that we have our action creators, let's set up our reducer for the whole thing.
// reducer.js
import {FETCH_PRODUCTS_PENDING, FETCH_PRODUCTS_SUCCESS, FETCH_PRODUCTS_ERROR} from './actions';
const initialState = {
pending: false,
products: [],
error: null
}
export function productsReducer(state = initialState, action) {
switch(action.type) {
case FETCH_PRODUCTS_PENDING:
return {
...state,
pending: true
}
case FETCH_PRODUCTS_SUCCESS:
return {
...state,
pending: false,
products: action.payload
}
case FETCH_PRODUCTS_ERROR:
return {
...state,
pending: false,
error: action.error
}
default:
return state;
}
}
export const getProducts = state => state.products;
export const getProductsPending = state => state.pending;
export const getProductsError = state => state.error;
Okay, now we have a big part of the work done.
What's to note in the code above, are the three functions at the end of the reducer. Those are called selectors. Selectors are used to get defined parts of the state. In small applications they are overkill. But if you scale your app and it gets more and more complex, it gets really messy if you change something within your state. With selectors you need to change the selector and everything works fine.
I'll propably do a blog post about selectors, because I think they are really important to set up a scalable react/redux application.
Now where were we... Ah yes, big part of the work is done. The only thing left for us to do on the redux side is to write one of our fancy new actions.
// fetchProducts.js
import {fetchProductsPending, fetchProductsSuccess, fetchProductsError} from 'actions';
function fetchProducts() {
return dispatch => {
dispatch(fetchProductsPending());
fetch('https://exampleapi.com/products')
.then(res => res.json())
.then(res => {
if(res.error) {
throw(res.error);
}
dispatch(fetchProductsSuccess(res.products);
return res.products;
})
.catch(error => {
dispatch(fetchProductsError(error));
})
}
}
export default fetchProducts;
The action above is pretty simple. First we dispatch our pending action. Then we fetch the data from our API. We decode the json coming in into an object. Then we check for an error. If an error happend we throw it and call our error function. If everything went okay, we call the success action. The reducer handles the rest.
This is all about fetching data from a server...Nah, just kidding, it isn't. But this is how most posts about fetching data from an api end, right? But...
What about our application?
Oh, you want the products from your store to actually show in your react app? Okay okay, let's do this.
I assume you know how to connect your react app to your redux store using a provider. There are plenty of posts about this topic out there. After you've done that, you'll need a few components.
For me everything starts in a view. A view, for me, is a component which wraps up everything a user gets served into one parent component. This parent component has most of the connection to the redux store and shares the data with the components it encapsulates.
import React, { Component } from 'react';
import PropTypes from 'prop-types';
import { connect } from 'react-redux';
import { bindActionCreators } from 'redux';
import fetchProductsAction from 'fetchProducts';
import {getProductsError, getProducts, getProductsPending} from 'reducer';
import LoadingSpinner from './SomeLoadingSpinner';
import ProductList from './ProductList';
class ProductView extends Component {
constructor(props) {
super(props);
this.shouldComponentRender = this.shouldComponentRender.bind(this);
}
componentWillMount() {
const {fetchProducts} = this.props;
fetchProducts();
}
shouldComponentRender() {
const {pending} = this.props;
if(this.pending === false) return false;
// more tests
return true;
}
render() {
const {products, error, pending} = this.props;
if(!this.shouldComponentRender()) return <LoadingSpinner />
return (
<div className='product-list-wrapper'>
{error && <span className='product-list-error'>{error}</span>}
<ProductList products={products} />
</div>
)
}
}
const mapStateToProps = state => ({
error: getProductsError(state),
products: getProducts(state),
pending: getProductsPending(state)
})
const mapDispatchToProps = dispatch => bindActionCreators({
fetchProducts: fetchProductsAction
}, dispatch)
export default connect(
mapStateToProps,
mapDispatchToProps
)(ProductView );
So, a lot is going on here. We write a standard React component. Then we use connect
to connect it to our redux store. Connect
takes two parameters: One function mapStateToProps
which maps parts of the state into your components props and one function mapDispatchToProps
which maps functions into your props which are, when called, dispatched to redux.
Right at the end we put all those things together and voilá, we have a connection to our store.
In the mapStateToProps function we make use of our selectors we wrote earlier.
I like to add a function called shouldComponentRender
to my view components and most of my components for that matter. I named it like this, because it's close to react's shouldComponentUpdate
lifecycle method. It checks whether or not the component should render. If not, it renders a LoadingSpinner component.
I find it very beneficial to work like this, because the components are always reinitialized and all subcomponents are mounted again after the pending flag, which controls the rendering in this case, toggles. Therefore you can add redux state to a component's state in the constructor. (I don't want to talk about what goes into redux and what goes into component state, this is a topic for another post).
In most of my projects I found this one of the most annoying problems. Think of a component which renders a product. It is initialized by the data and then some subcomponents like a price calculator, which has a component state, is initialized in its constructor. When new data comes in, you need to do a check whether or not the calculator needs to reinitialize. With the shouldComponentRender
function it's super easy to do so. Everytime the pending flag toggles (maybe because a new product is selected), everything reinitializes and is good to go.
Of course there are some reasons why you might have components within your view to not to rerender. If that's the case, just remove the shouldComponentRender
function from your view and work with it within the subcomponents.
You can use some kind of fadeout/-in effect to improve the user experience.
Well, that's it. For real this time.
Thank you for reading my first blog post ever. I hope you enjoyed it, I hope you learned something and if you have any suggestions or tips for me to improve my react/redux skills or just want to say "hi", leave me some comments, I'd really like that.
Oldest comments (60)
Hey Markus! Congrats on your first blog post! Shameless plug, I built a middleware a while ago to help reduce boilerplate especially with async actions like the ones you mentioned in this article, you should check it out!
github.com/Gabri3l/redux-slim-async
Hey Gabriele,
thanks for the tip. I know middlewares like yours. I used another one in a project recently. Was a real timesaver.
I will checkout yours for sure.
Any you would recommend to others out there ?
Recommend? Not really. I used redux-promise and redux-action to achieve something like your middleware does.
In small applications it was great (as I think your middleware will be) but in larger scale applications there were cases where the thunks got complicated and I had to get rid of all the middlewares I found and do it from scratch (or with my own middleware in that case)
That's interesting! I used this for a medium/large codebase and we were fine so if you have a minute to bring up a complicated Case that made those middlewares unhelpful that would be great! I'm curious to see if there's a way I can adapt this one too not intricate use cases.
Hi Gabriele, I'm learning about your middleware here,
Do you use it INSTEAD of thunk?
Hey Markus, thanks a lot for your guide. Great post!
Thank you very much for the comment Calum. :)
I did it a long time like you described and the solution was great. Then
componentWillRecieveProps
was marked asUNSAFE_componentWillReceiveProps
in React 16.3. It will become deprecated in React 17 and the newgetDerivedStateFromProps
is here.So I was wondering how I would solve this without depending to much on changes within the React lifecycle methodes and came up with my solution for the problem.
Putting the code into a function that sounded like a lifecycle method was my approach to keep the code readable and make everyone understand what is happening even if the code gets complicated. I keept it that way. :D
Also, I never got the idea why you would put state from redux into the react state if there is no reason to. I mean, you copy data from one state to another without doing anything with it. Seems like a waste of time. Can you enlighten me? Is there any benefit?
Even better :
componentWillReceiveProps did'nt call.
Is there a book or video describing the use of these react design patterns and/or the use of redux? For beginners maybe?
There are literally thousands out there. I can recommend Frontend Masters, they got plenty on all the relevant subjects but they are not free. Also YouTube is full of content. Udemy has some pretty good courses for little money, too.
its very good thanks Markus Claus
Nice post. One question. You do this:
but i don't see fetchProductsAction in fetchProducts.js. I see only fetchProducts. Is this a typo or some code is missing?. I believe is only a mistake but just want to confirm.
Thanks.
Thank you for the reply Alejandro.
You can import default exports with whatever name you want. I wanted to use
fetchProducts
in my code so I can't import it with this name because it would collide with the variable I use in a deeper scope.To fix this I import everything that is a action with xxxAction and then use it without the
Action
suffix.I hope this clarifies things.
You're right. I got confused. I'm learning react so i'm kind of new in those details and scanning the code properly.
Thanks!
You are welcome mate. Good luck learning :)
Hello! Is it possible to use a function component instead of a class component for ProductView ? How would the code change with useEffect hook? Thanks!
I actually wrote an article about React Hooks not long ago and there is an example for a fetch hook. Check it out
Hi Markus,
Thanks for the wonderful explanation.
Could you please explain why do we have to import the constants from ../actions.js in reducer.js?
import {FETCH_PRODUCTS_PENDING, FETCH_PRODUCTS_SUCCESS, FETCH_PRODUCTS_ERROR} from './actions';
Thank you for the article Markus!
redux-thunk is a great library, but not easy to test unfortunately, that’s why we decided to go with redux-saga, IMHO makes the code easier to maintain and the learning curve is not much difficult than thunk if you go to the great official documentation. Have you tried it?
Kudos!
I was stucked with this but thanks to your it's solved. This is the ebst guide ever, even being short.
Hi Markus, Nice tutorial can you please share the code.
Hello Markus, I'm getting fetchProducts() is not a function in your componentWillMount function. And I don't see where it is defined. ComponentWillMount is being depricated, but don't think that is why i'm getting this error. Thank you
componentWillMount() {
const {fetchProducts} = this.props;
fetchProducts();
}
yeah, it is giving error
Thanks this really helped me in my app
The best article to have a better understanding of redux and usage of APIs with redux. Thanks a bunch.
Hi Markus,
Let's assume i want to use some value from store and pass it as a parameter to products API call in fetchProducts.js. How can i access that ?? Something like
fetch(
https://exampleapi.com/products/${store.someVariable}
)how can i access store object in fetchProducts.js ??
There a few methods that can help you using state variable in thunk function:
You can export the state. Create a separate .js file and export the state object by using createStore(reducerName) method, then import that state object and use the getState() method to access the store.
You can directly use getState in your app-thunk function by simply passing it as an argument like return (dispatch,getState) => {} and then use this getState() method to access the store.
There are some other methods but these should work.