Что делает 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.