client-passive-event-listeners — правило для Claude Code
Правило client-passive-event-listeners учит агента добавлять { passive: true } к обработчикам событий скролла и тача, чтобы браузер не задерживал прокрутку страницы.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/client-passive-event-listeners.mdЧто делает client-passive-event-listeners
Правило инструктирует ассистента передавать флаг { passive: true } в вызовы addEventListener для событий touchstart и wheel. Без этого параметра браузер вынужден ожидать завершения функции, чтобы проверить, не вызван ли метод preventDefault(). В результате возникает ощутимая задержка при прокрутке экрана.
Инструкция разделяет сценарии использования. Пассивные слушатели нужны для систем аналитики, логирования и любых обработчиков, которым не требуется отменять стандартное поведение. Если же компонент реализует собственные жесты свайпа или кастомный зум с вызовом preventDefault(), флаг passive использовать нельзя.
Какие задачи решает
- устранить задержку прокрутки страницы при обработке событий касания и колеса мыши
- передать флаг
{ passive: true }в слушатели аналитики и трекинга действий пользователя - разделить обработчики жестов, требующие вызова
preventDefault(), и пассивные слушатели - оптимизировать реакцию интерфейса на события
wheelиtouchstartв хуках React
Примеры запросов агенту
- Проверь хук скролла в компоненте ленты и добавь
{ passive: true }во все обработчики событийwheel - Настрой отслеживание координат касания экрана в
useEffect, исключив блокировку скролла браузера - Отрефактори подписки на события
touchstartв модуле аналитики без отмены поведения по умолчанию
Как установить client-passive-event-listeners
Вручную: положить файлы
.claude/rules/client-passive-event-listeners.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/client-passive-event-listeners.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/client-passive-event-listeners.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/client-passive-event-listeners.mdВручную: положить файлы
.clinerules/client-passive-event-listeners.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о client-passive-event-listeners
Как установить client-passive-event-listeners в Claude Code?
Сохраните файл правила по пути .claude/rules/client-passive-event-listeners.md в корне вашего проекта.
Что делает правило client-passive-event-listeners?
Оно предписывает ассистенту использовать флаг { passive: true } при регистрации слушателей wheel и touchstart, устраняя задержку скролла.
Когда нельзя использовать пассивные слушатели событий?
Флаг passive нельзя ставить в обработчиках, вызывающих preventDefault(), например при создании кастомных жестов свайпа или зума.
Исходный текст
client-passive-event-listeners.md · MIT
---
title: Use Passive Event Listeners for Scrolling Performance
impact: MEDIUM
impactDescription: eliminates scroll delay caused by event listeners
tags: client, event-listeners, scrolling, performance, touch, wheel
---
## Use Passive Event Listeners for Scrolling Performance
Add `{ passive: true }` to touch and wheel event listeners to enable immediate scrolling. Browsers normally wait for listeners to finish to check if `preventDefault()` is called, causing scroll delay.
**Incorrect:**
```typescript
useEffect(() => {
const handleTouch = (e: TouchEvent) => console.log(e.touches[0].clientX)
const handleWheel = (e: WheelEvent) => console.log(e.deltaY)
document.addEventListener('touchstart', handleTouch)
document.addEventListener('wheel', handleWheel)
return () => {
document.removeEventListener('touchstart', handleTouch)
document.removeEventListener('wheel', handleWheel)
}
}, [])
```
**Correct:**
```typescript
useEffect(() => {
const handleTouch = (e: TouchEvent) => console.log(e.touches[0].clientX)
const handleWheel = (e: WheelEvent) => console.log(e.deltaY)
document.addEventListener('touchstart', handleTouch, { passive: true })
document.addEventListener('wheel', handleWheel, { passive: true })
return () => {
document.removeEventListener('touchstart', handleTouch)
document.removeEventListener('wheel', handleWheel)
}
}, [])
```
**Use passive when:** tracking/analytics, logging, any listener that doesn't call `preventDefault()`.
**Don't use passive when:** implementing custom swipe gestures, custom zoom controls, or any listener that needs `preventDefault()`.
© tech-leads-club · MIT · tech-leads-club/agent-skills