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

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

- 주소: https://copyandrun.com/blog/react-usestate-useeffect-basics/
- 분야: 시큐어코딩
- 발행일: 2026-11-14
- 태그: React, useState, useEffect, hook, cleanup

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

## 준비물

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

## 1. useState로 카운터 만들기

`src/components/Counter.jsx`

```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으로 세 번 누른 뒤 확인한 결과는 다음과 같습니다.

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

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

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

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

`src/components/Users.jsx`

```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로 바꿔, 사라진 컴포넌트에 늦게 도착한 값을 넣지 않도록 막습니다.

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

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

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

`src/App.jsx`

```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. 확인 체크리스트

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