re:re:actable
Урок 033 минуты чтения

Что делает createSlice

На этой странице
Кратко

createSlice создает slice — часть Redux-состояния с ее reducer и action creators — из одного описания: имени, начального состояния и функций-обработчиков в reducers. Внутри используется Immer, поэтому можно писать «мутирующий» код (state.items.push(...)), а RTK превратит его в иммутабельное обновление. Для реакции на чужие actions (например, из createAsyncThunk) используют extraReducers.

Вопрос

Что делает createSlice? Как в нем работают reducers, extraReducers, prepare и почему внутри можно «мутировать» state?

Основной пример

import { createSlice, type PayloadAction } from "@reduxjs/toolkit";
 
type CartItem = { id: string; title: string; price: number; qty: number };
type CartState = { items: CartItem[]; promo: string | null };
 
const initialState: CartState = { items: [], promo: null };
 
const cartSlice = createSlice({
  name: "cart",
  initialState,
  reducers: {
    itemAdded(state, action: PayloadAction<Omit<CartItem, "qty">>) {
      const existing = state.items.find((i) => i.id === action.payload.id);
      if (existing) existing.qty += 1;
      else state.items.push({ ...action.payload, qty: 1 });
    },
    itemRemoved(state, action: PayloadAction<string>) {
      state.items = state.items.filter((i) => i.id !== action.payload);
    },
    promoApplied(state, action: PayloadAction<string>) {
      state.promo = action.payload;
    },
    cartCleared() {
      return initialState;                    // можно вернуть новый state целиком
    },
  },
  selectors: {
    selectCartCount: (state) => state.items.reduce((n, i) => n + i.qty, 0),
  },
});
 
export const { itemAdded, itemRemoved, promoApplied, cartCleared } = cartSlice.actions;
export const { selectCartCount } = cartSlice.selectors;
export default cartSlice.reducer;

cartSlice.actions.itemAdded — action creator; itemAdded.type === "cart/itemAdded".

Immer: два способа обновить state

reducers: {
  // 1. мутировать draft — ничего не возвращать
  toggled(state, action: PayloadAction<string>) {
    const todo = state.find((t) => t.id === action.payload);
    if (todo) todo.done = !todo.done;
  },
  // 2. вернуть новое значение — не мутировать
  reset() {
    return [];
  },
}

Нельзя одновременно мутировать draft и возвращать новое значение — Immer бросит ошибку. Стрелочная функция (state) => state.value = 1 неявно возвращает значение — оборачивайте тело в фигурные скобки.

prepare: подготовка payload

todoAdded: {
  reducer(state, action: PayloadAction<Todo>) {
    state.push(action.payload);
  },
  prepare(text: string) {
    return { payload: { id: crypto.randomUUID(), text, done: false, createdAt: new Date().toISOString() } };
  },
},

Случайные id и даты создаются в prepare, а не в reducer — reducer остается чистым.

extraReducers: чужие actions

import { fetchCart } from "./cartThunks";
import { userLoggedOut } from "../auth/authSlice";
 
const cartSlice = createSlice({
  name: "cart",
  initialState: { ...initialState, status: "idle" as "idle" | "loading" | "failed" },
  reducers: { /* ... */ },
  extraReducers: (builder) => {
    builder
      .addCase(fetchCart.pending, (state) => { state.status = "loading"; })
      .addCase(fetchCart.fulfilled, (state, action) => {
        state.status = "idle";
        state.items = action.payload;
      })
      .addCase(fetchCart.rejected, (state) => { state.status = "failed"; })
      .addCase(userLoggedOut, () => initialState);   // action другого slice
  },
});

В RTK 2 extraReducers принимает только builder-callback; старая «объектная» запись удалена.

Что важно помнить

  • Один slice — одна фича или доменная сущность; имя (name) становится префиксом типов actions.
  • Immer работает только внутри createSlice/createReducer; в компоненте мутировать state из useSelector нельзя.
  • Reducer — чистый: запросы и таймеры — в thunk-ах или listener middleware.
  • Несколько slices могут реагировать на один action через extraReducers — так одно событие обновляет несколько частей state.
  • Поле selectors (RTK 2) получает state самого slice, а не весь RootState.

Мини-шпаргалка

createSlice({ name, initialState, reducers, extraReducers, selectors }) → slice.actions, slice.reducer, slice.selectors. Immer: мутируй draft или верни новый state, но не оба. Случайности — в prepare. Чужие actions — extraReducers: builder => builder.addCase(...).

Документация

Redux Toolkit: createSlice, Redux Toolkit: Writing Reducers with Immer, Redux Essentials: Redux App Structure.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам