rerender-functional-setstate — правило для Claude Code
Правило rerender-functional-setstate подсказывает использовать функциональное обновление React-состояния, когда новое значение зависит от текущего. Это помогает избежать устаревших замыканий в обработчиках.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/rerender-functional-setstate.mdЧто делает rerender-functional-setstate
Если новое состояние вычисляется из предыдущего, правило предлагает передавать в setState функцию: например, обновлять список через curr => [...], а не читать переменную состояния напрямую. Такой подход особенно уместен внутри useCallback, обработчиков событий и асинхронных операций.
В примерах с useCallback функциональная форма позволяет убрать состояние из массива зависимостей. Иначе callback может пересоздаваться при каждом изменении состояния или использовать устаревшее значение, если зависимость забыли. Для статического значения, например setCount(0), функциональная форма не нужна. При включённом React Compiler отдельные случаи могут оптимизироваться автоматически, но правило всё равно рекомендует функциональное обновление ради корректности.
Какие задачи решает
- Обновить состояние на основе его текущего значения
- Убрать лишнюю зависимость состояния из
useCallback - Избежать устаревшего значения в замыкании
- Сохранить стабильную ссылку на callback при изменении состояния
Примеры запросов агенту
- Проверь обновление списка в
TodoListи замени прямое чтение состояния функциональной формой, где это нужно. - Исправь callback удаления элемента, чтобы он всегда использовал актуальное состояние.
- Проверь обработчик события: зависит ли новое состояние от предыдущего?
Как установить rerender-functional-setstate
Вручную: положить файлы
.claude/rules/rerender-functional-setstate.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/rerender-functional-setstate.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/rerender-functional-setstate.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/rerender-functional-setstate.mdВручную: положить файлы
.clinerules/rerender-functional-setstate.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о rerender-functional-setstate
Как установить rerender-functional-setstate в Claude Code?
Добавь правило в файл .claude/rules/rerender-functional-setstate.md.
Что делает rerender-functional-setstate?
Правило рекомендует функциональную форму setState, когда обновление зависит от текущего состояния. Это помогает избежать устаревших замыканий и лишних зависимостей callback.
Нужно ли функциональное обновление при включённом React Compiler?
React Compiler может автоматически оптимизировать некоторые случаи. Правило всё равно рекомендует функциональную форму для корректности и защиты от устаревших замыканий.
Исходный текст
rerender-functional-setstate.md · MIT
---
title: Use Functional setState Updates
impact: MEDIUM
impactDescription: prevents stale closures and unnecessary callback recreations
tags: react, hooks, useState, useCallback, callbacks, closures
---
## Use Functional setState Updates
When updating state based on the current state value, use the functional update form of setState instead of directly referencing the state variable. This prevents stale closures, eliminates unnecessary dependencies, and creates stable callback references.
**Incorrect (requires state as dependency):**
```tsx
function TodoList() {
const [items, setItems] = useState(initialItems)
// Callback must depend on items, recreated on every items change
const addItems = useCallback((newItems: Item[]) => {
setItems([...items, ...newItems])
}, [items]) // ❌ items dependency causes recreations
// Risk of stale closure if dependency is forgotten
const removeItem = useCallback((id: string) => {
setItems(items.filter(item => item.id !== id))
}, []) // ❌ Missing items dependency - will use stale items!
return <ItemsEditor items={items} onAdd={addItems} onRemove={removeItem} />
}
```
The first callback is recreated every time `items` changes, which can cause child components to re-render unnecessarily. The second callback has a stale closure bug—it will always reference the initial `items` value.
**Correct (stable callbacks, no stale closures):**
```tsx
function TodoList() {
const [items, setItems] = useState(initialItems)
// Stable callback, never recreated
const addItems = useCallback((newItems: Item[]) => {
setItems(curr => [...curr, ...newItems])
}, []) // ✅ No dependencies needed
// Always uses latest state, no stale closure risk
const removeItem = useCallback((id: string) => {
setItems(curr => curr.filter(item => item.id !== id))
}, []) // ✅ Safe and stable
return <ItemsEditor items={items} onAdd={addItems} onRemove={removeItem} />
}
```
**Benefits:**
1. **Stable callback references** - Callbacks don't need to be recreated when state changes
2. **No stale closures** - Always operates on the latest state value
3. **Fewer dependencies** - Simplifies dependency arrays and reduces memory leaks
4. **Prevents bugs** - Eliminates the most common source of React closure bugs
**When to use functional updates:**
- Any setState that depends on the current state value
- Inside useCallback/useMemo when state is needed
- Event handlers that reference state
- Async operations that update state
**When direct updates are fine:**
- Setting state to a static value: `setCount(0)`
- Setting state from props/arguments only: `setName(newName)`
- State doesn't depend on previous value
**Note:** If your project has [React Compiler](https://react.dev/learn/react-compiler) enabled, the compiler can automatically optimize some cases, but functional updates are still recommended for correctness and to prevent stale closure bugs.
© tech-leads-club · MIT · tech-leads-club/agent-skills