React 외부 상태 관리, `useSyncExternalStore`로 매끄럽게 통합하기
React 18에 도입된 `useSyncExternalStore` 훅을 사용하여 외부 상태 관리 라이브러리와 React 컴포넌트 간의 통합을 간결하고 효율적으로 만드는 방법을 알아봅니다. 외부 상태 저장소의 구독, 스냅샷 가져오기, 서버 사이드 렌더링 지원 등 훅의 작동 방식과 장단점을 예제 코드를 통해 설명합니다.
React 애플리케이션을 개발하다 보면, 컴포넌트 간 상태 공유를 위해 Redux, Zustand, Jotai와 같은 외부 상태 관리 라이브러리를 사용하게 됩니다. 이러한 라이브러리들은 React의 상태 관리 방식과는 별개로 동작하는 경우가 많으며, React 컴포넌트에서 이들의 상태를 구독하고 업데이트하는 과정은 때때로 번거로울 수 있습니다. 특히, React 18에 도입된 useSyncExternalStore 훅은 이러한 외부 상태 관리 라이브러리와 React의 통합을 더욱 간결하고 효율적으로 만들어주는 강력한 도구입니다.
왜 useSyncExternalStore가 필요할까요?
기존에는 외부 상태 관리 라이브러리의 상태를 React 컴포넌트에서 사용하기 위해 라이브러리 자체에서 제공하는 구독(subscribe) 및 선택(select) 함수를 사용하거나, useState와 useEffect를 조합하여 수동으로 상태 변화를 감지하고 컴포넌트를 리렌더링해야 했습니다. 예를 들어, Zustand 같은 라이브러리를 사용한다고 가정해 봅시다. useStore와 같은 커스텀 훅을 직접 만들거나, 라이브러리에서 제공하는 useStore 훅을 사용하더라도 내부적으로는 이와 유사한 메커니즘이 동작합니다.
1// Zustand 예시 (일반적인 사용 방식) 2import { create } from 'zustand'; 3 4const useBearStore = create((set) => ({ 5 bears: 0, 6 increasePopulation: () => set((state) => ({ bears: state.bears + 1 })), 7 removeAllBears: () => set({ bears: 0 }), 8})); 9 10function BearCounter() { 11 const bears = useBearStore((state) => state.bears); 12 return <h1>{bears} around here ...</h1>; 13} 14 15function Controls() { 16 const increasePopulation = useBearStore((state) => state.increasePopulation); 17 return <button onClick={increasePopulation}>one up</button>; 18}
위 코드에서 useBearStore 훅은 내부적으로 상태를 구독하고 변경 시 컴포넌트를 업데이트하는 로직을 포함합니다. 하지만 이 방식은 라이브러리에 종속적인 코드를 작성하게 만들고, 때로는 React의 동시성(concurrency) 기능과 완벽하게 통합되지 않아 잠재적인 이슈를 발생시킬 수 있습니다. useSyncExternalStore는 이러한 외부 저장소와의 구독 및 동기화 로직을 React 코어 레벨에서 제공하여, 라이브러리 구현자가 이를 활용해 React와의 통합을 더욱 표준화하고 최적화할 수 있도록 돕습니다.
useSyncExternalStore의 작동 방식
useSyncExternalStore 훅은 세 개의 인자를 받습니다.
subscribe: 외부 저장소에 구독(subscribe)하는 함수입니다. 이 함수는 콜백 함수를 인자로 받아, 외부 저장소의 상태가 변경될 때마다 해당 콜백을 호출해야 합니다. 구독을 해제하는 함수를 반환해야 합니다.getSnapshot: 외부 저장소의 현재 상태 스냅샷(snapshot)을 반환하는 함수입니다.getServerSnapshot(선택 사항): 서버 사이드 렌더링(SSR) 시 사용될 초기 스냅샷을 반환하는 함수입니다. 클라이언트에서는 일반적으로getSnapshot과 동일한 함수를 사용합니다.
useSyncExternalStore는 이 함수들을 사용하여 외부 저장소의 상태 변화를 감지하고, 상태가 변경될 때마다 컴포넌트를 자동으로 리렌더링합니다. 특히, 이 훅은 React의 concurrent features (예: startTransition, useDeferredValue)와 함께 동작하도록 설계되어, 상태 변경으로 인한 UI 업데이트가 애플리케이션의 반응성을 해치지 않도록 합니다.
useSyncExternalStore를 이용한 외부 상태 관리 라이브러리 통합 예제 (Jotai)
Jotai는 심플하고 유연한 상태 관리 라이브러리로, useSyncExternalStore를 활용하여 React와의 통합을 강화할 수 있습니다. Jotai의 내부 구현을 살펴보면 useSyncExternalStore를 사용하는 것을 확인할 수 있습니다. 여기서는 Jotai를 직접 사용하는 대신, useSyncExternalStore를 사용하여 간단한 외부 상태 저장소를 만들고 이를 React 컴포넌트에서 사용하는 방법을 보여드리겠습니다.
먼저, 간단한 외부 상태 저장소를 정의합니다. 여기서는 EventEmitter 패턴을 사용하여 상태 변경을 알리는 방식을 사용합니다.
1// simpleStore.js 2let state = { count: 0 }; 3const listeners = new Set(); 4 5export const simpleStore = { 6 getState: () => state, 7 setState: (newState) => { 8 state = { ...state, ...newState }; 9 listeners.forEach((listener) => listener(state)); 10 }, 11 subscribe: (listener) => { 12 listeners.add(listener); 13 return () => { 14 listeners.delete(listener); 15 }; 16 }, 17};
이제 이 simpleStore를 useSyncExternalStore를 통해 React 컴포넌트에서 사용해 보겠습니다.
1// useSimpleStore.js 2import { useSyncExternalStore } from 'react'; 3import { simpleStore } from './simpleStore'; 4 5function subscribe(listener) { 6 return simpleStore.subscribe(listener); 7} 8 9function getSnapshot() { 10 return simpleStore.getState(); 11} 12 13// SSR을 위한 getServerSnapshot은 여기서는 클라이언트와 동일하게 처리 14const getServerSnapshot = getSnapshot; 15 16export function useSimpleStore() { 17 return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot); 18}
마지막으로, 이 커스텀 훅을 사용하여 React 컴포넌트에서 상태를 렌더링하고 업데이트하는 예제입니다.
1// App.js 2import React from 'react'; 3import { useSimpleStore } from './useSimpleStore'; 4import { simpleStore } from './simpleStore'; 5 6function App() { 7 const state = useSimpleStore(); 8 9 const increment = () => { 10 simpleStore.setState({ count: state.count + 1 }); 11 }; 12 13 return ( 14 <div> 15 <h1>Count: {state.count}</h1> 16 <button onClick={increment}>Increment</button> 17 </div> 18 ); 19} 20 21export default App;
이 예제에서 useSimpleStore 훅은 simpleStore의 상태 변화를 구독하고, 상태가 변경될 때마다 App 컴포넌트를 자동으로 리렌더링합니다. useSyncExternalStore 덕분에 외부 저장소의 상태 변화가 React의 렌더링 주기와 매끄럽게 동기화됩니다.
useSyncExternalStore의 장점
- 표준화된 통합: 외부 상태 관리 라이브러리 개발자는
useSyncExternalStore를 사용하여 React와의 통합 로직을 표준화할 수 있습니다. 이는 라이브러리의 일관성을 높이고, 개발자가 React의 새로운 기능과 더 잘 호환되도록 돕습니다. - 성능 최적화: React 18의 concurrent rendering과 호환되도록 설계되어, 상태 변경 시에도 UI가 멈추거나 버벅거리지 않도록 합니다.
getSnapshot함수가 호출될 때 React는 최신 스냅샷을 사용하여 렌더링을 즉시 완료할 수 있으며, 만약 렌더링 중에 외부 상태가 또 변경된다면 React는 해당 렌더링을 폐기하고 새 스냅샷으로 다시 렌더링할 수 있습니다. - 간결한 코드: 외부 라이브러리와의 연동을 위한 복잡한
useEffect,useState조합 대신,useSyncExternalStore라는 단일 API로 상태 동기화 로직을 구현할 수 있습니다.
주의할 점
getSnapshot함수는 동기적으로 스냅샷을 반환해야 합니다. 비동기 작업이 필요하다면, 해당 비동기 작업의 결과를 외부 저장소 자체에 반영하도록 구현해야 합니다.subscribe함수는 즉시 구독을 설정하고, 구독 해제 함수를 반환해야 합니다. React는 컴포넌트가 마운트 해제될 때 이 반환된 함수를 호출하여 구독을 정리합니다.useSyncExternalStore는 주로 라이브러리 개발자나 외부 상태 관리 솔루션을 깊게 다루는 경우에 유용합니다. 일반적인 React 컴포넌트 간 상태 공유는useState,useReducer,useContext와 같은 React 내장 훅으로 충분한 경우가 많습니다.
useSyncExternalStore는 React 생태계에서 외부 상태 관리 솔루션의 역할을 더욱 강화하고, React 애플리케이션의 성능과 개발 경험을 향상시키는 데 기여하는 중요한 훅입니다. 이를 통해 복잡한 상태 관리 로직을 더욱 깔끔하고 효율적으로 다룰 수 있게 되었습니다.
참고 자료: