client-event-listeners — правило для Claude Code: один слушатель
Правило client-event-listeners для Claude сводит глобальные подписки к одному слушателю: сколько бы компонентов ни вызывало хук, window получает один обработчик keydown.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/client-event-listeners.mdЧто делает client-event-listeners
Правило разбирает частый случай: кастомный хук вроде useKeyboardShortcut вешает обработчик keydown на window из useEffect. Каждый вызов добавляет свой addEventListener, и на десятом компоненте в браузере висит десять одинаковых слушателей.
Внутри файла два примера. Неправильный: тот самый useEffect с addEventListener на каждый инстанс. Правильный: модульный Map из клавиши в набор колбэков плюс один useSWRSubscription('global-keydown', ...), который подписывается на событие один раз и раздаёт его всем подписчикам. При размонтировании колбэк удаляется из Set, а опустевшая клавиша уходит из Map.
Импорт идёт из swr/subscription, поэтому swr в проекте должен уже стоять. В шапке правило помечено как LOW impact: это точечная чистка обработчиков, слой данных она не трогает.
Какие задачи решает
- убрать дубли
keydownпри подписке из нескольких компонентов - свести N обработчиков
windowк одному на приложение - перевести хук горячих клавиш на
useSWRSubscription - не забыть удалить колбэк из модульного
Mapпри размонтировании - показать в ревью, чем плох
useEffectсaddEventListenerв каждом инстансе
Примеры запросов агенту
- Перепиши
useKeyboardShortcutтак, чтобы наwindowвисел один слушательkeydown, а не по одному на каждый компонент. - Найди в проекте глобальные подписки и убери дубли через
useSWRSubscription. - Почему в
Profileрегистрируется несколько обработчиковkeydownи как свести их к одному?
Как установить client-event-listeners
Вручную: положить файлы
.claude/rules/client-event-listeners.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/client-event-listeners.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/client-event-listeners.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/client-event-listeners.mdВручную: положить файлы
.clinerules/client-event-listeners.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о client-event-listeners
Как установить client-event-listeners в Claude Code?
Положите файл правила по пути .claude/rules/client-event-listeners.md в проекте — текст берётся из репозитория tech-leads-club/agent-skills.
Что делает client-event-listeners?
Показывает, как заменить по одному глобальному слушателю на компонент общим: модульный Map колбэков плюс единственный useSWRSubscription на событие.
Что нужно, чтобы пример из правила заработал?
Пакет swr: импорт идёт из swr/subscription, без него код не соберётся.
Исходный текст
client-event-listeners.md · MIT
---
title: Deduplicate Global Event Listeners
impact: LOW
impactDescription: single listener for N components
tags: client, swr, event-listeners, subscription
---
## Deduplicate Global Event Listeners
Use `useSWRSubscription()` to share global event listeners across component instances.
**Incorrect (N instances = N listeners):**
```tsx
function useKeyboardShortcut(key: string, callback: () => void) {
useEffect(() => {
const handler = (e: KeyboardEvent) => {
if (e.metaKey && e.key === key) {
callback()
}
}
window.addEventListener('keydown', handler)
return () => window.removeEventListener('keydown', handler)
}, [key, callback])
}
```
When using the `useKeyboardShortcut` hook multiple times, each instance will register a new listener.
**Correct (N instances = 1 listener):**
```tsx
import useSWRSubscription from 'swr/subscription'
// Module-level Map to track callbacks per key
const keyCallbacks = new Map<string, Set<() => void>>()
function useKeyboardShortcut(key: string, callback: () => void) {
// Register this callback in the Map
useEffect(() => {
if (!keyCallbacks.has(key)) {
keyCallbacks.set(key, new Set())
}
keyCallbacks.get(key)!.add(callback)
return () => {
const set = keyCallbacks.get(key)
if (set) {
set.delete(callback)
if (set.size === 0) {
keyCallbacks.delete(key)
}
}
}
}, [key, callback])
useSWRSubscription('global-keydown', () => {
const handler = (e: KeyboardEvent) => {
if (e.metaKey && keyCallbacks.has(e.key)) {
keyCallbacks.get(e.key)!.forEach(cb => cb())
}
}
window.addEventListener('keydown', handler)
return () => window.removeEventListener('keydown', handler)
})
}
function Profile() {
// Multiple shortcuts will share the same listener
useKeyboardShortcut('p', () => { /* ... */ })
useKeyboardShortcut('k', () => { /* ... */ })
// ...
}
```
© tech-leads-club · MIT · tech-leads-club/agent-skills