pending과 error를 useState로 들고 있던 로그인 폼, React 19 Actions로 다시 써 보기
이 블로그의 관리자 로그인 폼은 React 18 시절 습관대로 짜여 있습니다. 같은 폼을 form action, useActionState, useFormStatus로 다시 쓰면서 무엇이 줄고 무엇을 조심해야 하는지 정리했습니다.
React 19 다시 배우기· 1 / 4펼치기접기
- 1. pending과 error를 useState로 들고 있던 로그인 폼, React 19 Actions로 다시 써 보기
- 2. 댓글을 달면 바로 보이게, TanStack Query로 해 둔 낙관적 업데이트를 useOptimistic과 비교해 봤습니다
- 3. getState()로 최신 값을 꺼내던 useEffect, use와 useEffectEvent로 덜어내기
- 4. useMemo를 지워도 될까요, 이 블로그에 React Compiler를 켜고 빌드해 봤습니다
이 블로그는 React 19.2 위에서 돌아갑니다. 그런데 코드를 다시 열어 보니 React 19에서 새로 생긴 API를 거의 쓰지 않고 있었습니다. 버전만 올라갔고, 손은 여전히 React 18 시절 습관대로 움직이고 있었던 거죠. 사실 제가 그랬습니다. 릴리스 노트는 읽었는데 "나중에 써 봐야지" 하고 넘긴 게 전부였습니다.
그래서 이 시리즈에서는 블로그 저장소에 실제로 있는 코드를 출발점으로 삼아, React 19 방식으로 다시 써 보려고 합니다. 첫 글에서는 관리자 로그인 폼을 가지고 액션(Actions), useActionState, useFormStatus를 다룹니다. 아직 블로그 코드에 반영하지는 않았고, 다시 쓴 코드는 이 글을 위해 만든 예시입니다.
1. 지금 코드는 상태를 손으로 관리합니다
/admin/login 페이지는 이메일과 비밀번호를 받아 Supabase로 로그인하고, 관리자가 아니면 바로 로그아웃시킵니다. 실제 코드에서 상태와 제출 부분만 추리면 이렇습니다.
const [error, setError] = useState("");
const [pending, setPending] = useState(false);
async function onSubmit(e: React.FormEvent<HTMLFormElement>) {
e.preventDefault();
setPending(true);
setError("");
const form = new FormData(e.currentTarget);
const db = createClient();
const { error } = await db.auth.signInWithPassword({
email: String(form.get("email")),
password: String(form.get("password")),
});
const { data: isAdmin } = error ? { data: false } : await db.rpc("is_admin");
if (error || !isAdmin) {
if (!error) await db.auth.signOut();
setError(error ? "이메일 또는 비밀번호가 올바르지 않습니다." : "관리자 계정이 아닙니다.");
setPending(false);
return;
}
router.replace("/admin");
router.refresh();
}동작에는 문제가 없습니다. 다만 비동기 요청 하나를 위해 지켜야 할 약속이 많습니다. 시작할 때 pending을 켜고, 에러를 비우고, 실패하면 다시 pending을 끄고, 성공하면 끄지 않아도 되는지 따져 봐야 합니다. setPending(false)를 한 군데라도 빠뜨리면 버튼이 영원히 비활성화됩니다.
2. 액션은 전환 안에서 실행되는 비동기 함수입니다
React 19에서는 비동기 전환(transition) 안에서 실행되는 함수를 액션(Action)이라고 부릅니다. <form>의 action 속성에 함수를 넘기면 React가 그 함수를 전환으로 감싸서 실행하고, 인자로 FormData를 넘겨 줍니다. e.preventDefault()도, new FormData(e.currentTarget)도 쓸 필요가 없습니다.
여기에 useActionState를 더하면 액션의 결과를 상태로 받을 수 있습니다. 반환값은 세 개입니다. 마지막 결과 상태, 폼에 넘길 액션, 그리고 실행 중인지를 뜻하는 isPending입니다.
const [state, formAction, isPending] = useActionState(actionFn, initialState);actionFn은 (이전 상태, FormData)를 받아 다음 상태를 돌려줍니다. 리듀서와 비슷한데 비동기라는 점이 다릅니다.
3. 같은 폼을 useActionState로 다시 썼습니다
type State = { error: string; email: string };
export default function AdminLoginPage() {
const router = useRouter();
const [state, formAction, isPending] = useActionState(
async (_prev: State, form: FormData): Promise<State> => {
const email = String(form.get("email"));
const db = createClient();
const { error } = await db.auth.signInWithPassword({ email, password: String(form.get("password")) });
const { data: isAdmin } = error ? { data: false } : await db.rpc("is_admin");
if (error || !isAdmin) {
if (!error) await db.auth.signOut();
return { error: error ? "이메일 또는 비밀번호가 올바르지 않습니다." : "관리자 계정이 아닙니다.", email };
}
router.replace("/admin");
router.refresh();
return { error: "", email };
},
{ error: "", email: "" },
);
return (
<form action={formAction}>
<input name="email" type="email" required defaultValue={state.email} />
<input name="password" type="password" required />
<button type="submit" disabled={isPending}>{isPending ? "..." : "Sign in"}</button>
{state.error && <p role="alert">{state.error}</p>}
</form>
);
}useState 두 개와 setPending 세 번이 사라졌습니다. 에러 메시지는 액션이 돌려준 값이 그대로 화면에 들어가고, isPending은 React가 알아서 켜고 끕니다. 실패 경로에서 무언가를 되돌려 놓을 필요가 없다는 점이 가장 마음에 들었습니다.
4. 폼이 저절로 비워지는 동작을 조심해야 합니다
문서를 읽다가 한 번 멈칫한 부분이 있습니다. <form action>에 함수를 넘기면, 액션이 끝난 뒤 React가 제어하지 않는 입력(uncontrolled input)을 초기값으로 되돌립니다. 액션이 에러 메시지를 반환해도 React 입장에서는 정상 종료이기 때문에, 비밀번호를 틀리면 이메일 칸까지 비워집니다.
위 코드에서 상태에 email을 같이 담고 defaultValue={state.email}로 넘긴 이유가 이것입니다. 초기값 자체를 방금 입력한 값으로 바꿔 두면, 폼이 초기화되어도 이메일은 남습니다. 비밀번호 칸은 비워지는 쪽이 오히려 자연스러워서 그대로 두었습니다.
반대로 초기화를 직접 해야 할 때는 react-dom의 requestFormReset(form)을 쓸 수 있습니다. 이 블로그의 댓글 입력처럼 useState로 값을 들고 있는 제어 입력(controlled input)은 이 자동 초기화의 대상이 아니라는 점도 함께 기억해 두었습니다.
5. 제출 버튼은 useFormStatus로 따로 뺄 수 있습니다
isPending을 버튼까지 props로 내려 주기 번거로울 때는 react-dom의 useFormStatus를 씁니다. 이 훅은 자신을 감싸고 있는 가장 가까운 <form>의 상태를 읽습니다.
import { useFormStatus } from "react-dom";
function SubmitButton({ children }: { children: React.ReactNode }) {
const { pending } = useFormStatus();
return <button type="submit" disabled={pending}>{pending ? "..." : children}</button>;
}주의할 점은 반드시 <form> 안쪽에 렌더링되는 컴포넌트에서 불러야 한다는 것입니다. 폼을 렌더링하는 컴포넌트 자신이 부르면 바깥 폼을 찾지 못해 pending이 늘 false입니다. 이 블로그처럼 관리자 화면에 폼이 여러 개라면 공통 버튼 하나로 모든 폼의 로딩 표시를 처리할 수 있을 것 같습니다.
6. 서버 함수와 붙이면 JavaScript 없이도 제출됩니다
지금 로그인은 브라우저용 Supabase 클라이언트를 쓰기 때문에 액션도 클라이언트 함수입니다. 그런데 useActionState에는 서버 함수(Server Function), 즉 "use server"가 붙은 함수도 그대로 넘길 수 있습니다. 이 블로그에도 src/lib/actions.ts에 캐시를 갱신하는 서버 함수가 이미 있습니다.
"use server";
export async function revalidateContent() {
// 관리자 확인 후
revalidatePath("/", "layout");
revalidatePath("/rss.xml");
}서버 함수를 폼 액션으로 쓰면, 서버에서 렌더링된 폼이 하이드레이션(hydration) 전에도 제출됩니다. 스크립트가 아직 내려오지 않았어도 일반 HTML 폼처럼 동작하는 거죠. React 문서에서는 이를 점진적 향상(progressive enhancement)이라고 부릅니다. 로그인을 서버 함수로 옮기려면 서버용 Supabase 클라이언트로 쿠키를 다뤄야 해서, 이 부분은 앞으로 해 볼 일로 남겨 두었습니다.
마치며
React 18 습관으로 짠 코드는 "요청 전에 켜고, 끝나면 끈다"를 사람이 지켜야 했습니다. 액션으로 바꾸고 나니 그 약속을 React가 대신 지켜 줍니다. 걱정했던 것보다 바꿀 양이 적었고, 줄어든 건 대부분 실수할 수 있는 줄이었습니다.
다만 폼 자동 초기화처럼 모르고 쓰면 당황할 동작도 있었습니다. 다음 글에서는 이 블로그의 댓글 영역을 가지고, TanStack Query로 이미 해 두었던 낙관적 업데이트를 useOptimistic과 비교해 보겠습니다.
Comments (0)