Skip to content

Thunk Dispatch

Thunk Dispatch sits at the heart of redux thunk in Redux. This guide walks through the concept step by step, with examples, a cheatsheet, and common mistakes to avoid.

Thunk Dispatch Overview

Thunk Dispatch lets you work with Redux in a way that stays clear, repeatable, and easy to scale. Instead of ad-hoc steps, you follow a pattern that other developers recognise immediately.

The key is to keep thunk dispatch focused and predictable. Start from the minimal example here, then add only the complexity your situation actually needs.

import { createAsyncThunk, createSlice } from '@reduxjs/toolkit';

export const fetchUser = createAsyncThunk('user/fetch', async (id) => {
  const res = await fetch(`/api/users/${id}`);
  return res.json();
});

const userSlice = createSlice({
  name: 'user',
  initialState: { data: null, status: 'idle' },
  reducers: {},
  extraReducers: (builder) => {
    builder
      .addCase(fetchUser.pending, (s) => { s.status = 'loading'; })
      .addCase(fetchUser.fulfilled, (s, a) => { s.status = 'idle'; s.data = a.payload; });
  },
});

createAsyncThunk handles async flows and dispatches pending/fulfilled/rejected actions automatically.

Thunk Dispatch Example

const slice = createSlice({ name, initialState, reducers });
const store = configureStore({ reducer: { key: slice.reducer } });
// dispatch(slice.actions.something())
  • Start from a minimal Thunk Dispatch example and grow it only as needed.
  • Keep things explicit so Thunk Dispatch behaves the same for everyone on the team.
  • Name things clearly so teammates understand your Thunk Dispatch at a glance.
  • Verify Thunk Dispatch works as expected before relying on it in important work.

Redux Cheatsheet

Quick Redux Toolkit reference related to thunk dispatch.

Concept Example Purpose
Store configureStore({ reducer }) Hold app state
Slice createSlice({ name, reducers }) State + actions together
Read state useSelector((s) => s.x) Get data in components
Dispatch useDispatch() Send actions
Async createAsyncThunk(...) Handle side effects
Data fetching createApi(...) RTK Query endpoints
Derived data createSelector(...) Memoized computations

How Thunk Dispatch Works in Redux

Thunk Dispatch follows Redux's predictable data flow: components dispatch actions, reducers compute the next state from the previous state and the action, and subscribed components re-render.

createAsyncThunk handles async flows and dispatches pending/fulfilled/rejected actions automatically.

  • State lives in a single, read-only store.
  • Actions are the only way to describe a change.
  • Reducers are pure functions that return the next state.
  • Redux Toolkit removes most boilerplate with slices and thunks.

Practical Guidance for Thunk Dispatch

In modern apps, thunk dispatch should use Redux Toolkit rather than hand-written Redux. Keep state minimal, colocate logic in slices, and use RTK Query for server data.

Concern Recommendation
Boilerplate Use Redux Toolkit (createSlice)
Server data Prefer RTK Query over manual thunks
Performance Memoize selectors with createSelector
Types Use typed useAppSelector/useAppDispatch hooks

Common Mistakes

  • Skipping edge cases and error handling when using thunk dispatch.
  • Not verifying the result of thunk dispatch before moving on.
  • Over-complicating thunk dispatch before you actually need the extra flexibility.
  • Ignoring documentation, which makes thunk dispatch hard for the next person to follow.

Key Takeaways

  • Thunk Dispatch is a core part of working effectively with Redux.
  • Start small and keep thunk dispatch focused on a single goal.
  • Apply consistent patterns so thunk dispatch scales across your project.
  • Practise and document thunk dispatch to keep your workflow maintainable.

Pro Tip

When you get stuck on thunk dispatch, reduce it to the smallest example first — most Redux problems become obvious once the noise is gone.