TypeScript Academy · 강의

Redux Toolkit 슬라이스 및 thunk 형식 지정

완전한 형식 추론과 함께 createSlice와 createAsyncThunk를 사용합니다.

Redux Toolkit 슬라이스 및 thunk 형식 지정은(는) CoddyKit의 무료 TypeScript Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 TypeScript Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. TypeScript Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

Redux Toolkit에 타입을 지정하는 이유

Redux Toolkit(RTK)은 뛰어난 TypeScript 지원을 제공합니다. 적절하게 타입을 지정하면 수동 타입 단언 없이 작업, 상태, 비동기 thunk에 모두 타입 안전성을 적용할 수 있습니다.

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

State 인터페이스에 타입 지정

슬라이스를 만들기 전에 슬라이스 상태를 TypeScript 인터페이스로 정의합니다.

interface UserState {
  users: User[];
  loading: boolean;
  error: string | null;
}

const initialState: UserState = {
  users: [],
  loading: false,
  error: null,
};

타입이 지정된 상태를 사용하는 createSlice

리듀서가 올바르게 타입이 지정된 상태를 받도록 상태 타입을 제네릭으로 전달합니다.

const userSlice = createSlice({
  name: "users",
  initialState,
  reducers: {
    setLoading(state, action: PayloadAction<boolean>) {
      state.loading = action.payload; // state: UserState — typed
    },
  },
});

PayloadAction 타입 지정

리듀서의 action.payload에 타입을 지정하려면 RTK의 PayloadAction을 사용합니다.

import { PayloadAction } from "@reduxjs/toolkit";

reducers: {
  addUser(state, action: PayloadAction<User>) {
    state.users.push(action.payload); // action.payload: User
  },
}

타입과 함께 사용하는 createAsyncThunk

반환 값, thunk 인수, thunk API 구성에 대한 타입을 제공합니다.

const fetchUsers = createAsyncThunk<User[], void, { rejectValue: string }>(
  "users/fetchAll",
  async (_, { rejectWithValue }) => {
    try {
      return await api.getUsers();
    } catch (e) {
      return rejectWithValue("Failed to fetch");
    }
  }
);

extraReducers에서 thunk 작업 처리

보류, 성공, 실패 상태의 thunk 작업을 완전히 타입이 지정된 방식으로 처리하려면 builder 콜백 API를 사용합니다.

const userSlice = createSlice({
  name: "users",
  initialState,
  reducers: {},
  extraReducers: (builder) => {
    builder
      .addCase(fetchUsers.pending, (state) => { state.loading = true; })
      .addCase(fetchUsers.fulfilled, (state, action) => {
        state.users = action.payload; // action.payload: User[]
        state.loading = false;
      })
      .addCase(fetchUsers.rejected, (state, action) => {
        state.error = action.payload ?? "Unknown error";
      });
  },
});

타입이 지정된 RootState와 AppDispatch

선택자와 훅에서 사용할 수 있도록 저장소 파일에서 타입이 지정된 RootState와 AppDispatch를 내보냅니다.

import { configureStore } from "@reduxjs/toolkit";
const store = configureStore({ reducer: { users: userSlice.reducer } });
export type RootState = ReturnType<typeof store.getState>;
export type AppDispatch = typeof store.dispatch;

타입이 지정된 useSelector와 useDispatch

모든 컴포넌트에서 타입 단언을 반복하지 않도록 타입이 지정된 Redux 훅을 만듭니다.

import { useDispatch, useSelector, TypedUseSelectorHook } from "react-redux";
export const useAppDispatch = () => useDispatch<AppDispatch>();
export const useAppSelector: TypedUseSelectorHook<RootState> = useSelector;

RTK Query 타입 지정

RTK Query는 엔드포인트 정의에서 완전히 타입이 지정된 훅을 생성하므로 응답 타입을 수동으로 지정할 필요가 없습니다.

const api = createApi({
  reducerPath: "api",
  baseQuery: fetchBaseQuery({ baseUrl: "/api" }),
  endpoints: (build) => ({
    getUser: build.query<User, string>({
      query: (id) => `/users/${id}`,
    }),
  }),
});
export const { useGetUserQuery } = api;

선택자 타입 지정

타입 안전한 상태 접근을 보장하도록 RootState를 사용해 타입이 지정된 선택자를 작성합니다.

const selectUsers = (state: RootState): User[] => state.users.users;
const selectLoading = (state: RootState): boolean => state.users.loading;

복습: 타입이 지정된 RTK

Redux Toolkit TypeScript에서는 상태 인터페이스를 정의하고, 리듀서에서 PayloadAction을 사용하며, createAsyncThunk 제네릭에 타입을 지정하고, RootState와 AppDispatch를 내보낸 다음 타입이 지정된 훅 래퍼를 만듭니다.

빠른 확인

RTK 리듀서에서 action.payload를 타입 안전하게 만드는 타입 표기는 무엇입니까?

학습한 내용

Redux Toolkit TypeScript에서는 슬라이스 상태 인터페이스를 정의하고, 리듀서에서 PayloadAction을 사용하며, createAsyncThunk에 세 가지 제네릭으로 타입을 지정합니다. 또한 타입이 지정된 RootState/AppDispatch와 컴포넌트에서 사용할 훅 래퍼를 내보냅니다.

자주 묻는 질문

“Redux Toolkit 슬라이스 및 thunk 형식 지정” 강의는 무료인가요?

네 — “Redux Toolkit 슬라이스 및 thunk 형식 지정” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 TypeScript Academy 강의 전체를 잠금 해제할 수 있습니다. TypeScript Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“Redux Toolkit 슬라이스 및 thunk 형식 지정”에서 뭘 배우나요?

완전한 형식 추론과 함께 createSlice와 createAsyncThunk를 사용합니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

TypeScript Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 TypeScript Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“Redux Toolkit 슬라이스 및 thunk 형식 지정” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 TypeScript Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 TypeScript Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← TypeScript Academy(으)로 돌아가기