К основному содержанию
правило CX Codex

advanced-event-handler-refs — правило для Claude Code

Правило advanced-event-handler-refs учит Claude Code сохранять колбэки в useRef или useEffectEvent внутри хуков эффектов, чтобы подписки на события не пересоздавались при каждом рендере.

MIT ★ 7 191 обновлён 2026-10-24

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/advanced-event-handler-refs.md
Открыть на GitHub

Что делает 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 и 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

Похожие правила IDE

Все правила IDE по теме «Фронтенд и UI» →
react18-string-refs официальный github Скилл react18-string-refs помогает заменить строковые refs в классовых компонентах на React.createRef(). Пригодится при переходе на React 18.3.1 или React 19. CX Codex +1 741установок llm-streaming-response-handler curiositech Скилл llm-streaming-response-handler настраивает потоковый вывод токенов через Server-Sent Events в интерфейсах чатов. Помогает добавить прерывание генерации, курсор набора текста и обработку сбоев сети. CX Codex +1 205установок react-advanced Claude MPM Team Скилл react-advanced для Claude Code задаёт правила работы с React 19: внедрение React Compiler, Actions, конкурентный рендеринг и отказ от лишнего useMemo. CX Codex +1 209установок remotion-performance-optimizer ncklrs Скилл remotion-performance-optimizer находит узкие места в Remotion-композициях: лишние перерисовки, тяжёлые расчёты, неоптимальные ассеты. Выдаёт отчёт с конкретными правками и оценкой ускорения. CX Codex +1 171установок react-state-minimize alexj11324 Правило react-state-minimize для Claude Code учит помощника убирать лишние переменные состояния React. Оно требует вычислять значения прямо в момент рендера. CX Codex +1 ★ 88звёзд репо react-flow-advanced existential-birds Скилл react-flow-advanced учит агента внедрять сложные паттерны в React Flow: группировку узлов, историю отмены действий, автоматическую раскладку через dagre и перетаскивание элементов. CX Codex +1 652установок

Из того же набора130

Весь набор →
rerender-derived-state-no-effect Правило rerender-derived-state-no-effect не даёт хранить вычисляемые значения в состоянии и обновлять их через эффект. Оно пригодится при ревью React-кода. CX Codex +1 ★ 7 191звёзд репо rerender-move-effect-to-event Правило rerender-move-effect-to-event требует запускать побочный эффект в обработчике события, которое его вызвало, а не через состояние и useEffect. CX Codex +1 ★ 7 191звёзд репо async-dependencies Правило async-dependencies направляет Claude Code на параллельный запуск асинхронных операций с частичными зависимостями через better-all или цепочки промисов вместо блокирующего Promise.all. CX Codex +1 ★ 7 191звёзд репо server-cache-lru Правило Claude Code server-cache-lru объясняет, когда заменить React.cache() на LRU-кэш между запросами. Показывает повторное использование общих данных в последовательных запросах. CX Codex +1 ★ 7 191звёзд репо server-parallel-fetching Правило server-parallel-fetching для Claude Code показывает, как перестроить React Server Components для параллельных независимых запросов данных. Устраняет цепочки загрузки, где компонент ждёт другого. CX Codex +1 ★ 7 191звёзд репо _sections Правило _sections для Claude Code, которое определяет восемь разделов оптимизации производительности, их приоритеты и порядок применения. Устанавливается один раз в проект и служит справочником при анализе кода агентом. CX Codex +1 ★ 7 191звёзд репо client-passive-event-listeners Правило client-passive-event-listeners учит агента добавлять { passive: true } к обработчикам событий скролла и тача, чтобы браузер не задерживал прокрутку страницы. CX Codex +1 ★ 7 191звёзд репо js-cache-storage Правило js-cache-storage требует держать значения localStorage, sessionStorage и cookie в памяти, а не дёргать синхронное хранилище на каждом вызове. CX Codex +1 ★ 7 191звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой