advanced-event-handler-refs — правило для Claude Code
Правило advanced-event-handler-refs учит Claude Code сохранять колбэки в useRef или useEffectEvent внутри хуков эффектов, чтобы подписки на события не пересоздавались при каждом рендере.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/advanced-event-handler-refs.mdЧто делает advanced-event-handler-refs
Правило задаёт паттерн работы с колбэками в React-хуках вроде useEffect. Вместо добавления функции-обработчика в массив зависимостей агент сохраняет её в ref и обновляет отдельным эффектом, либо использует useEffectEvent.
Прямое включение колбэка в зависимости заставляет хук повторно регистрировать слушатели событий при каждом изменении функции. Предлагаемый шаблон стабилизирует подписку: листенер регистрируется один раз по имени события, а внутри вызывает актуальное значение из ref.current.
Для работы альтернативного синтаксиса с useEffectEvent в проекте потребуется свежая версия React.
Какие задачи решает
- избавиться от повторных подписок на события окна при каждом рендере
- стабилизировать массивы зависимостей в кастомных хуках с
useEffect - переписать подписку на слушатели через
useEffectEventв коде на React
Примеры запросов агенту
- Сделай кастомный хук useWindowEvent для прослушивания кликов без лишних переподписок
- Проверь зависимости useEffect в хуке подписки на события клавиатуры
Как установить advanced-event-handler-refs
Вручную: положить файлы
.claude/rules/advanced-event-handler-refs.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/advanced-event-handler-refs.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/advanced-event-handler-refs.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/advanced-event-handler-refs.mdВручную: положить файлы
.clinerules/advanced-event-handler-refs.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы об advanced-event-handler-refs
Как установить advanced-event-handler-refs в Claude Code?
Сохраните файл правила в проект по пути .claude/rules/advanced-event-handler-refs.md.
Зачем сохранять обработчики событий в ref?
Это позволяет читать актуальный колбэк внутри слушателя и не добавлять саму функцию в зависимости useEffect. Подписка на событие остаётся стабильной и не пересоздаётся заново.
Когда вместо useRef стоит применять useEffectEvent?
useEffectEvent подходит для проектов на свежих версиях React. Он даёт чистый синтаксис и создаёт стабильную ссылку на обработчик без ручной синхронизации через ref.
Исходный текст
advanced-event-handler-refs.md · MIT
---
title: Store Event Handlers in Refs
impact: LOW
impactDescription: stable subscriptions
tags: advanced, hooks, refs, event-handlers, optimization
---
## Store Event Handlers in Refs
Store callbacks in refs when used in effects that shouldn't re-subscribe on callback changes.
**Incorrect (re-subscribes on every render):**
```tsx
function useWindowEvent(event: string, handler: (e) => void) {
useEffect(() => {
window.addEventListener(event, handler)
return () => window.removeEventListener(event, handler)
}, [event, handler])
}
```
**Correct (stable subscription):**
```tsx
function useWindowEvent(event: string, handler: (e) => void) {
const handlerRef = useRef(handler)
useEffect(() => {
handlerRef.current = handler
}, [handler])
useEffect(() => {
const listener = (e) => handlerRef.current(e)
window.addEventListener(event, listener)
return () => window.removeEventListener(event, listener)
}, [event])
}
```
**Alternative: use `useEffectEvent` if you're on latest React:**
```tsx
import { useEffectEvent } from 'react'
function useWindowEvent(event: string, handler: (e) => void) {
const onEvent = useEffectEvent(handler)
useEffect(() => {
window.addEventListener(event, onEvent)
return () => window.removeEventListener(event, onEvent)
}, [event])
}
```
`useEffectEvent` provides a cleaner API for the same pattern: it creates a stable function reference that always calls the latest version of the handler.
© tech-leads-club · MIT · tech-leads-club/agent-skills