본문으로 건너뛰기

React Deep · EP 01

React 19 핵심 정리: Actions와 useOptimistic

React 19의 form Actions, useActionState, useOptimistic로 폼과 낙관적 UI를 간단하게 만드는 방법을 정리합니다.

· 3분 읽기

React 19 핵심 정리: Actions와 useOptimistic

개요

지금까지 폼 제출은 onSubmit에서 e.preventDefault()를 부르고, 로딩 상태를 useState로 만들고, 에러를 또 다른 state로 관리하는 패턴을 반복해왔습니다. React 19의 Actions는 이 반복을 프레임워크 차원으로 끌어 올렸습니다. 실제 프로젝트에 적용하며 배운 것들을 정리합니다.

form Actions

React 19의 <form>은 action 속성에 함수를 받을 수 있습니다. 이 함수는 비동기 함수여도 되고, 제출 중 상태를 React가 관리합니다.

function AddTodo() {
  const [todos, setTodos] = useState<Todo[]>([]);

  async function addTodo(formData: FormData) {
    const title = formData.get('title') as string;
    const saved = await api.createTodo({ title });
    setTodos((prev) => [...prev, saved]);
  }

  return (
    <form action={addTodo}>
      <input name="title" required />
      <button type="submit">추가</button>
    </form>
  );
}

e.preventDefault()도, 별도의 isSubmitting state도 없습니다. 폼 데이터는 FormData로 그대로 받을 수 있어서 controlled 컴포넌트를 강제하지 않는 것도 편했습니다.

useActionState로 폼 상태 관리하기

제출 결과(성공/에러)를 보여주려면 useActionState를 씁니다. action 함수의 시그니처가 (prevState, formData) 형태로 바뀌고, 반환값이 폼 상태가 됩니다.

import { useActionState } from 'react';

function LoginForm() {
  const [state, formAction, isPending] = useActionState(
    async (prev: { error?: string }, formData: FormData) => {
      const email = formData.get('email') as string;
      const password = formData.get('password') as string;

      const result = await api.login({ email, password });
      if (!result.ok) {
        return { error: result.message };
      }
      return {};
    },
    {}
  );

  return (
    <form action={formAction}>
      <input name="email" type="email" required />
      <input name="password" type="password" required />
      {state.error && <p role="alert">{state.error}</p>}
      <button disabled={isPending}>{isPending ? '로그인 중…' : '로그인'}</button>
    </form>
  );
}

isPending은 hook이 그대로 제공해서 로딩 표시용 state도 필요 없어졌습니다.

useOptimistic으로 낙관적 UI

좋아요 버튼처럼 서버 응답을 기다리면 답답한 UI에는 낙관적 업데이트가 답이었습니다. useOptimistic은 서버 상태와 “임시로 보여줄 상태”를 함께 관리합니다.

function LikeButton({ postId, initialLiked }: { postId: string; initialLiked: boolean }) {
  const [liked, setLiked] = useState(initialLiked);
  const [optimisticLiked, addOptimistic] = useOptimistic(
    liked,
    (current, next: boolean) => next
  );

  async function toggle() {
    addOptimistic(!optimisticLiked);
    try {
      const result = await api.toggleLike(postId);
      setLiked(result.liked);
    } catch {
      // 에러 시 useOptimistic 값은 자동으로 롤백됩니다
      alert('처리에 실패했습니다.');
    }
  }

  return (
    <button onClick={toggle} aria-pressed={optimisticLiked}>
      {optimisticLiked ? '좋아요 취소' : '좋아요'}
    </button>
  );
}

핵심 동작은 이렇습니다. addOptimistic을 부르면 즉시 낙관적 값이 UI에 반영되고, transition이 끝나면(여기서는 setLiked가 확정되면) 원래 상태로 돌아갑니다. 요청이 실패하면 확정 state는 그대로이므로 자연스럽게 롤백됩니다.

적용하며 배운 점

  • 기존 useFormState는 useActionState로 이름이 바뀌었고, 제출 중 상태는 useActionState의 isPending으로도 접근할 수 있습니다.
  • Actions는 절대적 대체제가 아니라, 폼 중심의 뮤테이션에서 코드가 가장 많이 줄어듭니다.
  • Next.js의 Server Actions와 결합하면 api 호출 없이 서버 함수를 직접 넘길 수도 있습니다.

마무리

React 19의 Actions는 “폼 제출 + 로딩 + 에러 + 낙관적 업데이트”라는 흔한 조합의 보일러플레이트를 크게 줄여줬습니다. 특히 useOptimistic은 이전에 손대기 귀찮았던 낙관적 UI를 기본 도구처럼 쓰게 만들어준 것이 가장 큰 변화였습니다.

Related

· 18 min read Build Logs

damon-chat-desk 구축기 — 로컬 에이전트 데몬의 /ws 위에 얇은 웹 데스크를 얹기

로컬 AI 에이전트 데몬(damon-agent-core) 위에 정적 SPA 채팅 데스크를 얹었습니다. OpenAI 호환 경로 대신 /ws JSON-RPC v2와 일회용 ws_ticket을 고른 이유, 툴 실행 아코디언·turn.steer·plan.respond CAS·session.fork, 메모리 게이트(-32011)를 UI 문장으로 옮기는 법, ⌘K 팔레트, https 페이지에서 loopback 데몬에 붙을 수 없을 때의 demo 폴백까지 — PR 4건 +18,477줄, 테스트 223개, 번들 375kB의 기록입니다.

프론트엔드AI
→
· 15 min read Build Logs

AI 과제 지도(assignment-map) 구축기 — 수집기 흰 화면 복구부터 18종 레퍼런스 기반 UI 개편까지

채용 과제·해커톤의 AI 정책과 마감을 매일 수집하는 과제 지도를 6일 동안 PR 16건으로 고도화했습니다. evidence 문자열 하나가 배포 화면을 통째로 죽인 장애와 그 뿌리 수정, 18종 레퍼런스 실측에서 나온 PR A~E, npm ci 앞에서 돌던 테스트가 배포를 막은 CI 함정까지 실제 수치로 정리합니다.

프론트엔드AI
→
· 3 min read React Deep

React 에러 바운더리 제대로 쓰기

React 에러 바운더리가 클래스형인 이유, resetKeys로 재시도하는 패턴, 라우터 단위 격리 전략을 정리합니다.

React프론트엔드
→