Skip to content

Async Thunk Error Handling

In this lesson you will learn async thunk error handling in Redux, why it matters within createasyncthunk, and how to use it correctly with clear, copy-ready examples.

Async Thunk Error Handling Overview

At its core, async thunk error handling is about doing one thing well in Redux. Once you understand the pattern, you can apply it consistently across projects and teams.

Good async thunk error handling pays off across the whole project: fewer surprises, easier collaboration, and smoother onboarding. The snippet below is a solid starting point.

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.

Async Thunk Error Handling Example

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

Redux Cheatsheet

Quick Redux Toolkit reference related to async thunk error handling.

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 Async Thunk Error Handling Works in Redux

Async Thunk Error Handling 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 Async Thunk Error Handling

In modern apps, async thunk error handling 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

  • Copying async thunk error handling commands or snippets without understanding what each part does.
  • Skipping edge cases and error handling when using async thunk error handling.
  • Not verifying the result of async thunk error handling before moving on.
  • Over-complicating async thunk error handling before you actually need the extra flexibility.

Key Takeaways

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

Pro Tip

Bookmark this async thunk error handling pattern and reuse it. Consistency across your Redux work is worth more than clever one-off solutions.