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

client-event-listeners — правило для Claude Code: один слушатель

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

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

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

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

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

Все правила IDE по теме «Фронтенд и UI» →
swr Mindrally Инструкции по настройке SWR в связке с React и TypeScript. Помогает агенту писать хуки для выборки, кеширования и мутаций данных. CX Codex +1 918установок react-hooks-composition Claude MPM Team Скилл react-hooks-composition для Claude Code помогает собирать React-хуки для загрузки данных, поиска с задержкой и контекстов. Связывает состояние интерфейса с запросами к API. CX Codex +1 206установок apollo-client apollographql Скилл apollo-client для Claude Code помогает собирать React-приложения с Apollo Client 4.x. Он включается при настройке клиента, работе с GraphQL-запросами и мутациями или разборе ошибок. CX Codex +1 5 900установок create-client-tool cognitedata Скилл create-client-tool создаёт клиентский инструмент AtlasTool для чата useAtlasChat в веб-приложении. Он описывает схему TypeBox, настраивает вызов логики в браузере и подключает инструмент к чату. CX Codex +1 1 900установок nextjs-server-client-components wsimmonds Скилл nextjs-server-client-components помогает выбрать между Server и Client Components в Next.js App Router, настроить чтение cookies, работу с searchParams и избежать смешивания клиентских и серверных API. CX Codex +1 364установок nextjs-client-cookie-pattern wsimmonds Скилл nextjs-client-cookie-pattern для Claude Code показывает, как выставить серверную куку из клиентского компонента Next.js через server action. Описывает куки для тем, авторизации и языковых настроек. CX Codex +1 326установок

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

Весь набор →
js-tosorted-immutable Правило js-tosorted-immutable заменяет мутирующий .sort() на .toSorted(), чтобы сортировка не меняла массивы в props и state React. CX Codex +1 ★ 7 191звёзд репо patterns-children-over-render-props Правило patterns-children-over-render-props для Claude Code описывает композицию React-компонентов через children вместо renderX-пропсов, в том числе для формы с разросшимися колбэками. CX Codex +1 ★ 7 191звёзд репо js-cache-function-results Правило js-cache-function-results предписывает агенту кешировать результаты повторных вызовов чистых функций через Map на уровне модуля. Это снижает лишние вычисления при рендере в React и обычном JavaScript. CX Codex +1 ★ 7 191звёзд репо client-localstorage-schema Правило client-localstorage-schema учит версионировать ключи localStorage и сохранять только нужные интерфейсу поля. Оно пригодится при работе с настройками и кэшем пользовательских данных. CX Codex +1 ★ 7 191звёзд репо server-after-nonblocking Правило server-after-nonblocking учит агента переносить логирование, аналитику и фоновые задачи в функцию after() из Next.js. Это убирает задержку при отправке ответа клиенту. CX Codex +1 ★ 7 191звёзд репо rerender-lazy-state-init Правило rerender-lazy-state-init напоминает передавать в useState функцию, если начальное значение требует дорогих вычислений. Это пригодится в React-компонентах с данными из хранилища или сложными структурами. CX Codex +1 ★ 7 191звёзд репо async-defer-await Правило async-defer-await учит откладывать операции await только на те ветки кода, где они действительно нужны. Это избегает блокировки путей выполнения, которые могут вернуться раньше. CX Codex +1 ★ 7 191звёзд репо server-dedup-props server-dedup-props — правило для Claude Code о дедупликации данных в React Server Components. Объясняет, почему серверные трансформации массивов дублируют payload и их следует переносить в клиент. CX Codex +1 ★ 7 191звёзд репо

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

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