전체 내역
  • study
  • 13 min read
  • 조회수1

getState()로 최신 값을 꺼내던 useEffect, use와 useEffectEvent로 덜어내기

이 블로그 코드에는 오래된 값을 피하려고 스토어를 직접 읽거나, 의존성 배열을 비워 두려고 useCallback을 쓴 effect가 있습니다. React 19의 use와 19.2의 useEffectEvent로 이런 effect를 어디까지 덜어낼 수 있는지 살펴봤습니다.

React 19 다시 배우기· 3 / 4펼치기
  1. 1. pending과 error를 useState로 들고 있던 로그인 폼, React 19 Actions로 다시 써 보기
  2. 2. 댓글을 달면 바로 보이게, TanStack Query로 해 둔 낙관적 업데이트를 useOptimistic과 비교해 봤습니다
  3. 3. getState()로 최신 값을 꺼내던 useEffect, use와 useEffectEvent로 덜어내기
  4. 4. useMemo를 지워도 될까요, 이 블로그에 React Compiler를 켜고 빌드해 봤습니다

이 블로그의 검색 팔레트는 ⌘K로 열고 닫습니다. 그 단축키를 처리하는 useEffect 안에 이런 줄이 있습니다. setPaletteOpen(!useUI.getState().paletteOpen). 컴포넌트가 이미 paletteOpen을 들고 있는데도 굳이 스토어에서 다시 꺼내 읽습니다. 이 코드를 처음 봤을 때는 왜 이렇게 했는지 바로 떠오르지 않았습니다.

이유를 따라가 보니 effect 안의 오래된 값(stale closure) 문제를 피하려던 흔적이었습니다. 이 글에서는 이런 우회 코드를 React 19의 use와 19.2에서 정식으로 들어온 useEffectEvent로 정리할 수 있는지 살펴봅니다. 마지막에는 19.2의 Activity도 이 블로그 에디터에 대입해 봤습니다. 다른 편과 마찬가지로 블로그 코드는 아직 바꾸지 않았습니다.

1. getState()는 의존성 배열을 피하려는 우회였습니다

src/components/CommandPalette.tsx의 단축키 처리 코드입니다.

useEffect(() => {
  const onKey = (e: KeyboardEvent) => {
    if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === "k") {
      e.preventDefault();
      setPaletteOpen(!useUI.getState().paletteOpen);
    }
  };
  window.addEventListener("keydown", onKey);
  return () => window.removeEventListener("keydown", onKey);
}, [setPaletteOpen]);

onKey 안에서 paletteOpen을 그대로 읽으면, effect가 처음 실행될 때의 값에 묶입니다. 그렇다고 의존성 배열에 paletteOpen을 넣으면 팔레트를 열고 닫을 때마다 리스너를 뗐다 붙입니다. 동작은 하지만 하는 일에 비해 요란합니다. 그래서 Zustand 스토어의 getState()로 늘 최신 값을 읽는 쪽을 택했던 겁니다.

이 우회는 Zustand라서 가능했습니다. 값이 useState나 props였다면 같은 방법을 쓸 수 없었을 겁니다.

2. useEffectEvent는 effect 안에서 최신 값을 읽게 해 줍니다

useEffectEvent는 effect 안에서 부르되, 반응할 필요는 없는 로직을 따로 떼어 내는 훅입니다. 이렇게 만든 함수는 호출될 때마다 가장 최근 렌더링의 props와 상태를 읽고, 의존성 배열에 넣지 않습니다.

const togglePalette = useEffectEvent(() => setPaletteOpen(!paletteOpen));
 
useEffect(() => {
  const onKey = (e: KeyboardEvent) => {
    if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === "k") {
      e.preventDefault();
      togglePalette();
    }
  };
  window.addEventListener("keydown", onKey);
  return () => window.removeEventListener("keydown", onKey);
}, []);

리스너는 한 번만 붙고, 토글할 때는 늘 지금의 paletteOpen을 읽습니다. 스토어 구현에 기대지 않아도 되니 useState로 바꿔도 그대로 동작합니다.

React 문서가 못 박아 둔 규칙도 있습니다. useEffectEvent로 만든 함수는 effect 안에서만 불러야 하고, 다른 컴포넌트나 훅에 넘기면 안 됩니다. 이벤트 핸들러를 대신하는 도구가 아니라, effect에서 쓰는 로직의 일부를 반응성에서 빼 주는 도구라서 그렇습니다.

3. 빈 의존성 배열을 위한 useCallback도 같은 문제였습니다

lab에 있는 동네 지도 예제(NeighborhoodMap.tsx)에도 비슷한 코드가 있습니다.

const selectPlace = useCallback((id: LandmarkId, focus = false) => {
  selection.current = id; setSelected(id); setBuilding(null);
  setVisited((previous) => previous.includes(id) ? previous : [...previous, id]);
  engine.current?.select(id, focus);
}, []);
 
useEffect(() => {
  // 지도 엔진을 만들면서 클릭 콜백으로 selectPlace를 넘긴다
  instance = createMapEngine(host.current, { onSelect: (id) => selectPlace(id) /* ... */ });
  // ...
}, [attempt, selectPlace]);

여기서 useCallback은 성능 때문이 아니라 지도 엔진을 다시 만들지 않으려고 쓴 것입니다. 함수가 렌더링마다 새로 만들어지면 effect가 다시 실행되고, 그러면 지도를 지웠다가 다시 그리게 되니까요. 다행히 지금은 함수 안에서 최신 상태가 필요 없도록 함수형 업데이트와 ref로만 짜여 있어서 문제가 없습니다. 하지만 나중에 누가 여기에 상태 하나를 읽는 줄을 넣으면, 빈 의존성 배열 때문에 오래된 값을 읽는 버그가 생깁니다.

useEffectEvent로 바꾸면 그 걱정이 줄어듭니다. 다만 selectPlace는 장소 목록의 클릭 핸들러에서도 쓰기 때문에 통째로 바꿀 수는 없습니다. effect 안에서 쓰는 부분만 감싸는 게 맞습니다.

function selectPlace(id: LandmarkId, focus = false) { /* 그대로 */ }
const onMapSelect = useEffectEvent((id: LandmarkId) => selectPlace(id));
 
useEffect(() => {
  instance = createMapEngine(host.current, { onSelect: (id) => onMapSelect(id) /* ... */ });
}, [attempt]);

목록 버튼은 평범한 함수를 부르고, 지도 콜백은 effect 이벤트를 부릅니다. 규칙대로 effect 안에서만 부르고 있으니, 지도 엔진에 넘기는 것도 함수 자체가 아니라 그 함수를 부르는 화살표 함수입니다.

4. 바뀐 값에 맞춰 상태를 되돌리는 effect는 필요 없었습니다

같은 팔레트 컴포넌트에 한 줄짜리 effect가 하나 더 있습니다.

useEffect(() => {
  const t = setTimeout(() => setDebounced(q.trim()), 200);
  return () => clearTimeout(t);
}, [q]);
useEffect(() => setActive(0), [debounced]);

검색어가 바뀌면 선택된 항목을 첫 번째로 되돌리는 코드입니다. 이건 React 19와 상관없는 이야기지만, effect를 덜어 내는 김에 같이 봤습니다. 두 번째 effect는 렌더링이 끝난 뒤에 상태를 한 번 더 바꾸기 때문에, 화면이 한 번 더 그려집니다. debounced를 바꾸는 바로 그 자리에서 함께 바꾸면 effect 하나가 사라집니다.

useEffect(() => {
  const t = setTimeout(() => { setDebounced(q.trim()); setActive(0); }, 200);
  return () => clearTimeout(t);
}, [q]);

두 상태 변경은 한 번에 묶여서 처리되니 렌더링도 한 번으로 줄어듭니다. "상태가 바뀌었을 때 다른 상태를 맞추는 effect"는 대부분 이렇게 바꾸는 쪽에서 처리할 수 있었습니다.

5. use는 Promise를 렌더링 중에 읽습니다

React 19의 use는 Promise나 Context를 렌더링 중에 읽는 API입니다. 다른 훅과 달리 조건문 안에서도 부를 수 있습니다. Promise를 넘기면 값이 올 때까지 컴포넌트가 일시 중단(suspend)되고, 가장 가까운 Suspense가 대체 화면을 보여 줍니다.

이 블로그의 글 수정 에디터(PostEditor.tsx)는 지금 이렇게 초기값을 채웁니다. TanStack Query로 글을 불러오고, 불러오기가 끝나면 effect에서 폼 상태를 채웁니다. 글을 폼 값으로 바꾸는 부분은 toDraft로 줄여 적었습니다.

const [form, setForm] = useState<Draft | null>(null);
const ready = !id || post.isSuccess;
useEffect(() => {
  if (!ready || form) return;
  const saved = useDrafts.getState().drafts[key];
  setForm(saved ?? (post.data ? toDraft(post.data) : EMPTY));
}, [ready, form, post.data, key]);

use를 쓰면 서버 컴포넌트인 페이지에서 글을 가져오는 Promise를 만들고, 에디터에 넘겨 렌더링 중에 읽을 수 있습니다. 아래의 getPost와 toDraft는 설명을 위해 만든 함수입니다.

// page.tsx (서버 컴포넌트)
export default async function EditPostPage({ params }: PageProps<"/admin/posts/[id]">) {
  const postPromise = getPost((await params).id);
  return (
    <Suspense fallback={<p>불러오는 중...</p>}>
      <PostEditor postPromise={postPromise} />
    </Suspense>
  );
}
 
// PostEditor.tsx (클라이언트 컴포넌트)
const post = use(postPromise);
const [form, setForm] = useState(() => toDraft(post));

form이 null일 수 있다는 분기와 effect가 함께 사라집니다. Promise는 서버 컴포넌트에서 만들어 넘겨야 합니다. 클라이언트 컴포넌트 렌더링 중에 Promise를 새로 만들면 렌더링마다 새 Promise가 생겨서, 계속 일시 중단되기 때문입니다.

6. 하지만 임시 원고 때문에 그대로 옮길 수는 없었습니다

여기까지 쓰고 나서 지금 코드가 왜 effect를 썼는지 다시 보게 됐습니다. 에디터는 쓰다 만 원고를 브라우저 저장소(localStorage)에 임시 저장해 두고, 다시 열면 그걸 먼저 불러옵니다. 그런데 useState의 초기값 함수는 서버 렌더링에서도 실행됩니다. 서버에는 브라우저 저장소가 없으니 서버는 저장된 글로, 브라우저는 임시 원고로 첫 화면을 그리게 되고, 하이드레이션 결과가 어긋납니다.

결국 "저장된 글은 use로 받고, 임시 원고는 브라우저에서만 덮어쓴다"로 나눠야 합니다. 이 부분은 effect를 완전히 없애기보다, 브라우저 전용 값을 언제 읽을지 정하는 문제였습니다. 기존 코드가 form을 null로 시작한 데에도 이유가 있었던 셈입니다.

7. Activity는 이 에디터에는 필요 없었습니다

19.2에서 들어온 Activity는 화면에서 숨긴 부분의 상태를 지우지 않고 남겨 두는 컴포넌트입니다. mode="hidden"이면 자식을 숨기고 effect를 정리하되, 상태와 DOM은 남겨 둡니다. 숨겨진 동안의 렌더링은 우선순위를 낮춰서 처리합니다.

에디터의 쓰기와 미리보기 탭에 쓰면 좋겠다고 생각했는데, 코드를 보니 이미 해결되어 있었습니다. 넓은 화면에서는 두 칸을 나란히 보여 주고, 좁은 화면에서는 max-md:hidden 클래스로 한쪽을 숨길 뿐 언마운트하지 않습니다. 탭을 오가도 입력 중인 내용과 스크롤 위치가 그대로입니다. 넓은 화면에서 둘 다 보여야 하니 Activity로 감싸면 오히려 동작이 달라집니다.

Activity가 힘을 쓰는 곳은 조건부 렌더링으로 화면을 아예 지웠다가 다시 그리는 곳입니다. 이 블로그에서는 아직 그런 곳을 찾지 못했습니다.

마치며

getState()와 빈 의존성 배열의 useCallback은 둘 다 effect가 오래된 값을 읽지 않게 하려는 우회였습니다. useEffectEvent가 그 의도를 이름으로 드러내 준다는 점이 가장 좋았습니다.

반대로 use는 생각만큼 바로 옮겨지지 않았습니다. 지우려던 effect에는 임시 원고라는 이유가 있었고, 그걸 알고 나니 기존 코드가 조금 다르게 보였습니다. 다음 글에서는 이 블로그에 React Compiler를 실제로 켜고 빌드해 본 결과를 정리하겠습니다.

Comments (0)