# client-event-listeners

Правило client-event-listeners для Claude сводит глобальные подписки к одному слушателю: сколько бы компонентов ни вызывало хук, window получает один обработчик keydown.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 7191 у репозитория
- Автор: tech-leads-club
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/tech-leads-club/agent-skills/tree/HEAD/packages/skills-catalog/skills/(quality)/react-best-practices/rules/client-event-listeners.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/client-event-listeners

## Что делает

Правило разбирает частый случай: кастомный хук вроде `useKeyboardShortcut` вешает обработчик `keydown` на `window` из `useEffect`. Каждый вызов добавляет свой `addEventListener`, и на десятом компоненте в браузере висит десять одинаковых слушателей.

Внутри файла два примера. Неправильный: тот самый `useEffect` с `addEventListener` на каждый инстанс. Правильный: модульный `Map` из клавиши в набор колбэков плюс один `useSWRSubscription('global-keydown', ...)`, который подписывается на событие один раз и раздаёт его всем подписчикам. При размонтировании колбэк удаляется из `Set`, а опустевшая клавиша уходит из `Map`.

Импорт идёт из `swr/subscription`, поэтому `swr` в проекте должен уже стоять. В шапке правило помечено как LOW impact: это точечная чистка обработчиков, слой данных она не трогает.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/rules/client-event-listeners.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/client-event-listeners.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/client-event-listeners.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/client-event-listeners.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/client-event-listeners.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/tech-leads-club/agent-skills/tree/HEAD/packages/skills-catalog/skills/(quality)/react-best-practices/rules/client-event-listeners.md

## Когда брать
- убрать дубли `keydown` при подписке из нескольких компонентов
- свести N обработчиков `window` к одному на приложение
- перевести хук горячих клавиш на `useSWRSubscription`
- не забыть удалить колбэк из модульного `Map` при размонтировании
- показать в ревью, чем плох `useEffect` с `addEventListener` в каждом инстансе

## Примеры запросов агенту
- Перепиши `useKeyboardShortcut` так, чтобы на `window` висел один слушатель `keydown`, а не по одному на каждый компонент.
- Найди в проекте глобальные подписки и убери дубли через `useSWRSubscription`.
- Почему в `Profile` регистрируется несколько обработчиков `keydown` и как свести их к одному?

## Похожие
- [swr](https://affpapa.org/nevibecode/skills/mindrally-swr.md) — скилл · 918 установок
- [react-hooks-composition](https://affpapa.org/nevibecode/skills/react-hooks-composition.md) — скилл · 206 установок
- [apollo-client](https://affpapa.org/nevibecode/skills/apollo-client.md) — скилл · 5900 установок
- [create-client-tool](https://affpapa.org/nevibecode/skills/create-client-tool.md) — скилл · 1900 установок
- [nextjs-server-client-components](https://affpapa.org/nevibecode/skills/nextjs-server-client-components.md) — скилл · 364 установки
- [nextjs-client-cookie-pattern](https://affpapa.org/nevibecode/skills/nextjs-client-cookie-pattern.md) — скилл · 326 установок

Из того же набора: [tech-leads-club/agent-skills](https://affpapa.org/nevibecode/by/tech-leads-club/agent-skills.md) — 130 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
