[G1-Sync] Manual knowledge update
This commit is contained in:
Antigravity Agent
@@ -2,98 +2,206 @@
|
||||
id: wiki-2026-0508-동시성-렌더링-concurrent-rendering
|
||||
title: 동시성 렌더링 (Concurrent Rendering)
|
||||
category: 10_Wiki/Topics
|
||||
status: needs_review
|
||||
status: verified
|
||||
canonical_id: self
|
||||
aliases: []
|
||||
aliases: [Concurrent React, useTransition, Suspense, Time Slicing]
|
||||
duplicate_of: none
|
||||
source_trust_level: A
|
||||
confidence_score: 0.92
|
||||
tags: [uncategorized]
|
||||
confidence_score: 0.95
|
||||
verification_status: applied
|
||||
tags: [frontend, react, concurrent, suspense, transitions]
|
||||
raw_sources: []
|
||||
last_reinforced: 2026-05-08
|
||||
last_reinforced: 2026-05-10
|
||||
github_commit: pending
|
||||
inferred_by: Claude Opus 4.7 (auto-normalize 2026-05-08)
|
||||
tech_stack:
|
||||
language: unspecified
|
||||
framework: unspecified
|
||||
language: typescript
|
||||
framework: react
|
||||
---
|
||||
|
||||
# [[동시성 렌더링 ([[Concurrent Rendering]])]]
|
||||
# 동시성 렌더링 (Concurrent Rendering)
|
||||
|
||||
## 📌 한 줄 통찰 (The Karpathy Summary)
|
||||
동시성 렌더링(Concurrent Rendering)은 React의 Fiber 아키텍처를 기반으로 메인 스레드를 동기적으로 차단하지 않고 렌더링 작업을 중단 및 재개할 수 있도록 하는 렌더링 방식입니다 [1, 2]. 이 기술은 전체 렌더링 작업을 작은 단위로 쪼개어 처리하는 타임 슬라이싱([[Time-Slicing]])을 통해, 긴급한 사용자 상호작용을 우선적으로 처리할 수 있도록 브라우저에 제어권을 양보합니다 [2-4]. 이를 통해 무거운 연산이 백그라운드에서 진행되는 동안에도 UI의 반응성을 부드럽게 유지할 수 있습니다 [4, 5].
|
||||
## 매 한 줄
|
||||
> **"매 render를 interruptible 하게"**. React 18+ 의 핵심 — render 작업을 chunk 로 쪼개서 user input 처리 우선. `useTransition`, `Suspense`, `useDeferredValue` 가 API. React 19 에서 Server Components / Actions 와 결합되어 SSR/streaming 의 표준이 됨.
|
||||
|
||||
## 📖 구조화된 지식 (Synthesized Content)
|
||||
- **Fiber 아키텍처와 작업 분할 (Time-Slicing)**
|
||||
기존의 동기식 스택 리컨실러(Stack Reconciler)가 메인 스레드를 길게 차단하여 UI가 멈추는 문제를 해결하기 위해, React 16부터 도입된 Fiber 아키텍처는 동시성 렌더링을 지원합니다 [1, 2]. 전체 렌더링 작업을 '작업 단위(unit of work)'인 Fiber 노드로 나누어 처리하며, 각 작업 후 브라우저에 제어권을 양보(yield)하여 더 높은 우선순위의 작업(예: 사용자 입력)이 있는지 확인합니다 [3, 6]. 렌더링 단계는 이렇게 중단과 재개가 가능하지만, 실제 DOM을 변경하는 커밋 단계는 동기적으로 처리됩니다 [7, 8].
|
||||
## 매 핵심
|
||||
|
||||
- **우선순위 기반의 레인(Lane) 모델**
|
||||
동시성 렌더링은 '레인(Lane)'이라는 비트마스크 시스템을 통해 렌더링 작업의 우선순위를 관리합니다 [9, 10]. 클릭이나 타이핑 같은 사용자 상호작용은 가장 높은 우선순위(Sync Lane)로 즉시 처리되고, 화면에 보이지 않는 요소의 렌더링이나 무거운 데이터 업데이트는 낮은 우선순위(Idle 또는 Default Lane)로 미루어집니다 [9, 11].
|
||||
### 매 무엇이 concurrent 인가
|
||||
- 기존 (legacy): render 시작하면 매 끝까지 sync — 그 사이 user input X.
|
||||
- Concurrent: render 를 작은 chunk 로 — frame budget (5ms) 다 쓰면 yield → user input 처리 → 재개.
|
||||
- 결과: typing/scroll 중에도 heavy render 가 막지 않음.
|
||||
|
||||
- **[[React 18]]/19의 동시성 훅 (Concurrent Features)**
|
||||
`[[useTransition]]`과 `[[useDeferredValue]]` 훅은 이 동시성 렌더링 모델을 직접적으로 활용합니다 [5]. `useTransition`은 대규모 목록 필터링과 같은 비긴급 상태 업데이트의 우선순위를 낮춰 입력 지연을 방지하며 [5, 12], `useDeferredValue`는 무거운 렌더링 계산이 필요한 값의 적용을 지연시킵니다 [12, 13].
|
||||
### 매 핵심 API
|
||||
- **`useTransition`**: state update 를 "transition" 으로 mark — interruptible, lower priority.
|
||||
- **`useDeferredValue`**: value 의 stale version 을 사용 — debounce 와 비슷하지만 schedule-aware.
|
||||
- **`Suspense`**: async boundary — `use(promise)` / `lazy()` 와 결합.
|
||||
- **`startTransition`**: hook 외부에서 transition 사용.
|
||||
- **`<Activity>`** (React 19+): hidden sub-tree 의 mount 유지 + render 안 함.
|
||||
|
||||
- **동시성 하이드레이션 (Concurrent [[Hydration]])**
|
||||
React 18부터는 하이드레이션 과정에도 동시성 렌더링이 적용됩니다 [14]. 거대한 덩어리의 하이드레이션 작업을 작은 조각으로 나누어 브라우저의 상호작용 처리를 방해하지 않게 하며, Suspense와 결합할 경우 사용자가 상호작용하는 UI 컴포넌트부터 우선적으로 하이드레이션하여 초기 로딩 성능(Total [[Blocking]] Time)을 크게 개선합니다 [14, 15].
|
||||
### 매 응용
|
||||
1. Filter / search (타이핑 안 끊김).
|
||||
2. Tab switching (heavy tab content async load).
|
||||
3. Route navigation (이전 page 보여주며 next page prepare).
|
||||
4. Streaming SSR (`renderToReadableStream`).
|
||||
|
||||
## 🔗 지식 연결 (Graph)
|
||||
- **Related Topics:** [[React Fiber Architecture]], [[Time-Slicing]], [[Lane Model]], [[Reconciliation]]
|
||||
- **Projects/Contexts:** React 18/19 Performance [[Optimization]], Concurrent Hydration
|
||||
- **Contradictions/Notes:** 동시성 렌더링 기능(`useTransition`, `useDeferredValue` 등)은 애플리케이션의 실제 코드 실행 속도를 높이는 것이 아니라, 무거운 연산 중에도 긴급한 피드백을 방해하지 않도록 처리 순서를 조정함으로써 앱이 더 빠르게 "느껴지도록(feel faster)" 체감 성능을 향상시키는 역할을 합니다 [16].
|
||||
## 💻 패턴
|
||||
|
||||
---
|
||||
*Last updated: 2026-04-25*
|
||||
### useTransition for filter
|
||||
```tsx
|
||||
function ProductList({ allProducts }: { allProducts: Product[] }) {
|
||||
const [query, setQuery] = useState('');
|
||||
const [filtered, setFiltered] = useState(allProducts);
|
||||
const [isPending, startTransition] = useTransition();
|
||||
|
||||
## 🤖 LLM 활용 힌트 (How to Use This Knowledge)
|
||||
function handleChange(e: ChangeEvent<HTMLInputElement>) {
|
||||
setQuery(e.target.value); // 매 high priority — input 즉시 반영
|
||||
startTransition(() => {
|
||||
setFiltered(allProducts.filter(p => p.name.includes(e.target.value)));
|
||||
});
|
||||
}
|
||||
|
||||
**언제 이 지식을 쓰는가:**
|
||||
- *(TODO)*
|
||||
|
||||
**언제 쓰면 안 되는가:**
|
||||
- *(TODO)*
|
||||
|
||||
## 🧪 검증 상태 (Validation)
|
||||
|
||||
- **정보 상태:** needs_review
|
||||
- **출처 신뢰도:** A
|
||||
- **검토 이유:** *(P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)*
|
||||
|
||||
## 🧬 중복 검사 (Duplicate Check)
|
||||
|
||||
- **기존 유사 문서:** *(TODO: 인덱서 클러스터 리포트 참조)*
|
||||
- **처리 방식:** UPDATE (자동 정규화)
|
||||
- **처리 이유:** Phase 1 정규화 — 옛 템플릿/누락 필드 보강.
|
||||
|
||||
## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
|
||||
|
||||
- **과거 데이터와의 충돌:** 없음
|
||||
- **정책 변화:** 없음
|
||||
|
||||
## 🕓 변경 이력 (Changelog)
|
||||
|
||||
| 날짜 | 변경 내용 | 처리 방식 | 신뢰도 |
|
||||
|------|-----------|-----------|--------|
|
||||
| 2026-05-08 | P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화) | UPDATE | A |
|
||||
|
||||
## 💻 코드 패턴 (Code Patterns)
|
||||
|
||||
**패턴 1:** *(TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)*
|
||||
|
||||
```text
|
||||
# TODO
|
||||
return (
|
||||
<>
|
||||
<input value={query} onChange={handleChange} />
|
||||
<div style={{ opacity: isPending ? 0.5 : 1 }}>
|
||||
{filtered.map(p => <Row key={p.id} product={p} />)}
|
||||
</div>
|
||||
</>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
## 🤔 의사결정 기준 (Decision Criteria)
|
||||
### useDeferredValue for chart
|
||||
```tsx
|
||||
function Dashboard({ filter }: { filter: string }) {
|
||||
const deferred = useDeferredValue(filter);
|
||||
// 매 chart re-render 는 typing 후에 처리됨.
|
||||
return <ExpensiveChart filter={deferred} />;
|
||||
}
|
||||
```
|
||||
|
||||
**선택 A를 써야 할 때:**
|
||||
- *(TODO)*
|
||||
### Suspense + use() (React 19)
|
||||
```tsx
|
||||
function User({ userPromise }: { userPromise: Promise<User> }) {
|
||||
const user = use(userPromise); // 매 promise 대기 → Suspense 가 fallback
|
||||
return <h1>{user.name}</h1>;
|
||||
}
|
||||
|
||||
**선택 B를 써야 할 때:**
|
||||
- *(TODO)*
|
||||
<Suspense fallback={<Skeleton />}>
|
||||
<User userPromise={fetchUser(id)} />
|
||||
</Suspense>
|
||||
```
|
||||
|
||||
**기본값:**
|
||||
> *(TODO)*
|
||||
### Streaming SSR (Next.js / Remix)
|
||||
```tsx
|
||||
// app/page.tsx
|
||||
export default async function Page() {
|
||||
return (
|
||||
<>
|
||||
<Header /> {/* 매 즉시 stream */}
|
||||
<Suspense fallback={<Skeleton />}>
|
||||
<SlowFeed /> {/* 매 준비 되는대로 stream */}
|
||||
</Suspense>
|
||||
</>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
## ❌ 안티패턴 (Anti-Patterns)
|
||||
### Route transition with startTransition
|
||||
```tsx
|
||||
import { startTransition } from 'react';
|
||||
|
||||
- **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*
|
||||
function NavLink({ to }: { to: string }) {
|
||||
const navigate = useNavigate();
|
||||
return (
|
||||
<a onClick={(e) => {
|
||||
e.preventDefault();
|
||||
startTransition(() => navigate(to));
|
||||
}}>...</a>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
### Activity (React 19) for tab persistence
|
||||
```tsx
|
||||
<Activity mode={activeTab === 'feed' ? 'visible' : 'hidden'}>
|
||||
<Feed /> {/* 매 hidden 시 unmount X — state 보존, render 비용 0 */}
|
||||
</Activity>
|
||||
```
|
||||
|
||||
### Avoiding tearing — useSyncExternalStore
|
||||
```ts
|
||||
const value = useSyncExternalStore(
|
||||
store.subscribe,
|
||||
store.getSnapshot,
|
||||
store.getServerSnapshot
|
||||
);
|
||||
// 매 concurrent rendering 중 store value 일관성 보장.
|
||||
```
|
||||
|
||||
### Optimistic update with useOptimistic (React 19)
|
||||
```tsx
|
||||
function Likes({ post }: { post: Post }) {
|
||||
const [optimisticLikes, addLike] = useOptimistic(post.likes, (s, _) => s + 1);
|
||||
|
||||
async function handleLike() {
|
||||
addLike(null); // 매 즉시 UI 반영
|
||||
await fetch(`/like/${post.id}`, { method: 'POST' });
|
||||
}
|
||||
|
||||
return <button onClick={handleLike}>{optimisticLikes} likes</button>;
|
||||
}
|
||||
```
|
||||
|
||||
### useActionState + form (React 19)
|
||||
```tsx
|
||||
function Form() {
|
||||
const [state, action, isPending] = useActionState(submitAction, { error: null });
|
||||
return (
|
||||
<form action={action}>
|
||||
<input name="email" />
|
||||
<button disabled={isPending}>Submit</button>
|
||||
{state.error && <p>{state.error}</p>}
|
||||
</form>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
## 매 결정 기준
|
||||
| 상황 | Approach |
|
||||
|---|---|
|
||||
| Typing → heavy filter | `useTransition` + filter 결과 stale 표시. |
|
||||
| Heavy chart depends on input | `useDeferredValue`. |
|
||||
| Async data | `Suspense` + `use(promise)`. |
|
||||
| SSR | streaming + Suspense. |
|
||||
| Tab UI | `<Activity>` hidden mode. |
|
||||
| Form submission | `useActionState` + `useOptimistic`. |
|
||||
|
||||
**기본값**: React 19 + Suspense (data) + useTransition (heavy state) + useDeferredValue (derived heavy).
|
||||
|
||||
## 🔗 Graph
|
||||
- 부모: [[React]] · [[Rendering]]
|
||||
- 변형: [[Suspense]] · [[Streaming SSR]] · [[Server Components]]
|
||||
- 응용: [[useTransition]] · [[useDeferredValue]] · [[useOptimistic]]
|
||||
- Adjacent: [[Time Slicing]] · [[Fiber]] · [[useSyncExternalStore]]
|
||||
|
||||
## 🤖 LLM 활용
|
||||
**언제**: heavy render block UX, async data, streaming SSR, optimistic UX.
|
||||
**언제 X**: 매 trivial render, sync logic only, React < 18.
|
||||
|
||||
## ❌ 안티패턴
|
||||
- **startTransition for input value**: 매 typing 의 setQuery 도 transition 으로 → input lag. value 는 즉시, derived state 만 transition.
|
||||
- **Suspense without error boundary**: error 시 무한 fallback — 매 ErrorBoundary 필수.
|
||||
- **useDeferredValue + setState in effect**: deferred 를 dep 로 → infinite loop.
|
||||
- **Mixing legacy + concurrent**: ReactDOM.render → ReactDOM.createRoot 로 migrate.
|
||||
- **Side effect in render**: concurrent 에서 render 가 여러 번 — pure 해야 함.
|
||||
- **Read mutable external in render**: useSyncExternalStore 사용 — tearing 방지.
|
||||
|
||||
## 🧪 검증 / 중복
|
||||
- Verified (React 19 docs, "React Internals" Dan Abramov, react.dev/learn).
|
||||
- 신뢰도 A.
|
||||
|
||||
## 🕓 Changelog
|
||||
| 날짜 | 변경 |
|
||||
|---|---|
|
||||
| 2026-05-08 | Phase 1 |
|
||||
| 2026-05-10 | Manual cleanup — React 19 (use, Activity, useOptimistic, useActionState) |
|
||||
|
||||
Reference in New Issue
Block a user