Copy & Run

React useState와 useEffect 기초: 카운터와 데이터 불러오기

useState로 화면이 바뀌는 값을 만들고, useEffect로 화면 밖 작업(문서 제목 바꾸기, 데이터 불러오기)을 처리합니다. 클릭 테스트와 정리 함수(cleanup)가 실제로 동작하는지 헤드리스 Chromium으로 확인합니다.

실습 노트 · 2026-11-14 발행 · 6분 · 2026-11 확인

React 화면은 state가 바뀔 때 다시 그려집니다. useState는 값을 저장하고 바꾸는 도구이고, useEffect는 렌더링 바깥에서 일어나는 일(브라우저 제목 바꾸기, 시간 지연 후 데이터 넣기 같은 작업)을 맡는 도구입니다. 이 글에서는 앞 글의 프로젝트에 카운터와 사용자 목록을 추가하고, 두 훅이 어떻게 함께 동작하는지 확인합니다.

준비물

항목 내용
프로젝트 React 시작하기: Vite로 프로젝트 만들고 첫 컴포넌트 작성하기 글의 react-lab
React 19.3.1
Vite 8.3.8
확인용 브라우저 헤드리스 Chromium (Playwright)
예상 소요 시간 약 25분

1. useState로 카운터 만들기

src/components/Counter.jsx

import { useEffect, useState } from "react";

export default function Counter() {
  const [count, setCount] = useState(0);

  useEffect(() => {
    document.title = `클릭 ${count}번`;
  }, [count]);

  return (
    <section>
      <p>클릭 {count}번</p>
      <button onClick={() => setCount(count + 1)}>+1</button>
    </section>
  );
}

useState(0)은 count의 시작 값을 0으로 두고, 바꾸는 함수 setCount를 돌려줍니다. 버튼을 누르면 setCount가 호출되고, React는 새 count로 컴포넌트를 다시 그립니다. 변수를 직접 바꾸면 화면이 갱신되지 않으므로 반드시 setCount를 씁니다.

2. useEffect로 문서 제목 바꾸기

useEffect의 두 번째 인자 [count]는 "이 값이 바뀔 때만 실행하라"는 뜻입니다. 화면에 그릴 값이 아니라 브라우저 탭 제목처럼 React 바깥의 상태를 맞출 때 씁니다.

헤드리스 Chromium으로 세 번 누른 뒤 확인한 결과는 다음과 같습니다.

immediately: 클릭 3번
after 300ms: 클릭 3번 | title: 클릭 3번

화면 글자와 문서 제목이 같은 count를 보고 있습니다. 화면에 보이는 값은 count에서 바로 계산하고, useEffect에는 제목처럼 밖으로 내보내는 일만 맡기면 됩니다.

3. useEffect로 데이터 불러오기와 정리(cleanup)

실제 서비스라면 fetch로 데이터를 받습니다. 여기서는 외부 네트워크 없이 같은 동작을 보기 위해 300ms 뒤에 값을 넣는 예를 씁니다.

src/components/Users.jsx

import { useEffect, useState } from "react";

const SAMPLE = [
  { id: 1, name: "김하나" },
  { id: 2, name: "이둘" },
];

export default function Users() {
  const [users, setUsers] = useState([]);
  const [loading, setLoading] = useState(true);

  useEffect(() => {
    let cancelled = false;
    setTimeout(() => {
      if (!cancelled) {
        setUsers(SAMPLE);
        setLoading(false);
      }
    }, 300);
    return () => {
      cancelled = true;
    };
  }, []);

  if (loading) return <p>불러오는 중</p>;
  return (
    <ul>
      {users.map((u) => (
        <li key={u.id}>{u.name}</li>
      ))}
    </ul>
  );
}

[]는 컴포넌트가 처음 나타날 때 한 번만 실행하라는 뜻입니다. return 아래의 함수가 정리(cleanup)입니다. 컴포넌트가 화면에서 사라지거나 effect가 다시 실행되기 전에 React가 이 함수를 먼저 실행합니다. 여기서는 cancelled를 true로 바꿔, 사라진 컴포넌트에 늦게 도착한 값을 넣지 않도록 막습니다.

테스트에서는 잠시 뒤 두 사용자 이름이 나타났습니다. "불러오는 중" 문구는 로딩 상태를 확인하기 위해 같은 코드에 넣었지만, 이 글에서는 그 순간을 따로 캡처하지 않았습니다.

before: 클릭 0번 | users: 김하나 이둘

4. 두 훅을 한 화면에 모으기

src/App.jsx

import Counter from "./components/Counter.jsx";
import Greeting from "./components/Greeting.jsx";
import Users from "./components/Users.jsx";

export default function App() {
  return (
    <main>
      <h1>첫 React 컴포넌트</h1>
      <Greeting name="copyandrun" />
      <Counter />
      <Users />
    </main>
  );
}

npm run build는 성공했습니다. 버튼을 세 번 누르면 화면과 제목이 모두 클릭 3번이 됩니다.

5. 확인 체크리스트

  • useState로 만든 count를 버튼 클릭으로 바꾸고, 화면에 새 값이 나오는 것을 확인했습니다.
  • useEffect로 문서 제목을 맞추고, 세 번 클릭 뒤 제목이 클릭 3번인 것을 확인했습니다.
  • 빈 의존성 배열 []에서 300ms 뒤 사용자 두 명이 한 번 나타나는 것을 확인했습니다.
  • cleanup 함수가 cancelled 플래그를 세우는 코드를 작성하고 빌드가 성공하는 것을 확인했습니다.

이 글의 다음 단계

이 내용을 팀 교육으로 진행하고 싶으신가요?

인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.

교육 문의하기

교육 진행 순서와 자주 묻는 질문 보기

팀이나 교육 담당자에게 이 글 제안하기

메일로 보내실 수도 있습니다: fankh111@gmail.com

같은 카테고리의 글