Loading source
Pulling the file list, source metadata, and syntax-aware rendering for this listing.
Source from repo
Apply 62 React and Next.js performance optimization rules from Vercel Engineering
Files
Skill
Size
Entrypoint
Format
Open file
Syntax-highlighted preview of this file as included in the skill package.
rules/rerender-use-deferred-value.md
1---2title: Use useDeferredValue for Expensive Derived Renders3impact: MEDIUM4impactDescription: keeps input responsive during heavy computation5tags: rerender, useDeferredValue, optimization, concurrent6---78## Use useDeferredValue for Expensive Derived Renders910When user input triggers expensive computations or renders, use `useDeferredValue` to keep the input responsive. The deferred value lags behind, allowing React to prioritize the input update and render the expensive result when idle.1112**Incorrect (input feels laggy while filtering):**1314```tsx15function Search({ items }: { items: Item[] }) {16const [query, setQuery] = useState('')17const filtered = items.filter(item => fuzzyMatch(item, query))1819return (20<>21<input value={query} onChange={e => setQuery(e.target.value)} />22<ResultsList results={filtered} />23</>24)25}26```2728**Correct (input stays snappy, results render when ready):**2930```tsx31function Search({ items }: { items: Item[] }) {32const [query, setQuery] = useState('')33const deferredQuery = useDeferredValue(query)34const filtered = useMemo(35() => items.filter(item => fuzzyMatch(item, deferredQuery)),36[items, deferredQuery]37)38const isStale = query !== deferredQuery3940return (41<>42<input value={query} onChange={e => setQuery(e.target.value)} />43<div style={{ opacity: isStale ? 0.7 : 1 }}>44<ResultsList results={filtered} />45</div>46</>47)48}49```5051**When to use:**5253- Filtering/searching large lists54- Expensive visualizations (charts, graphs) reacting to input55- Any derived state that causes noticeable render delays5657**Note:** Wrap the expensive computation in `useMemo` with the deferred value as a dependency, otherwise it still runs on every render.5859Reference: [React useDeferredValue](https://react.dev/reference/react/useDeferredValue)60