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

js-request-idle-callback — правило для Claude Code

Правило js-request-idle-callback учит агента уводить аналитику, сохранение состояния и предзагрузку в простой браузера, чтобы интерфейс не подвисал на кликах.

MIT ★ 1 216 обновлён 2026-10-24

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settings
Открыть на GitHub

Что делает js-request-idle-callback

Правило требует отдавать некритичную работу в requestIdleCallback(), оставляя главный поток свободным для ввода и анимаций. Разобрано на обработчике поиска: результаты уходят в состояние сразу, а analytics.track, запись в недавние запросы и предзагрузка первых результатов переезжают в колбэки простоя.

Внутри — пары «как неправильно / как правильно» на TypeScript. Отдельно показан timeout вторым аргументом: задача выполнится не позже срока, даже если браузер так и не освободился. Ещё один разбор — нарезка длинного массива на порции по deadline.timeRemaining(), с повторной постановкой колбэка, пока элементы не кончатся.

Подмена через setTimeout нужна не для красоты: там, где метода window.requestIdleCallback нет, вызов без фолбэка сломается. Всё, что чувствительно ко времени, и отрисовка, которую пользователь ждёт, остаются синхронными — правило прямо перечисляет эти случаи как неподходящие для простоя.

Какие задачи решает

  • убрать аналитику из обработчика поиска, чтобы ввод не подвисал
  • нарезать обработку большого массива по deadline.timeRemaining()
  • поставить timeout, чтобы событие ушло при занятом браузере
  • подменить API на setTimeout там, где requestIdleCallback не поддерживается
  • отличить задачу, которую можно отложить, от той, что ждёт пользователь

Примеры запросов агенту

  • Перепиши handleSearch: результаты показывай сразу, а analytics.track и сохранение в недавние запросы убери в requestIdleCallback.
  • Пройдись по файлу по правилу js-request-idle-callback и покажи, какие задачи можно отложить до простоя браузера.
  • Добавь фолбэк на setTimeout для браузеров без requestIdleCallback.

Как установить js-request-idle-callback

1Через маркетплейс плагинов

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settings

2Вручную: положить файлы

.claude/rules/js-request-idle-callback.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о js-request-idle-callback

Как установить js-request-idle-callback в Claude Code?

Через маркетплейс: сначала /plugin marketplace add fcakyon/claude-codex-settings, потом /plugin install react-skills@claude-settings. Само правило лежит в .claude/rules/js-request-idle-callback.md.

Что делает js-request-idle-callback?

Показывает агенту, как переносить некритичную работу — аналитику, сохранение состояния, предзагрузку — в requestIdleCallback(), чтобы не блокировать главный поток во время действий пользователя.

Что нельзя откладывать до простоя?

Реакцию на действие пользователя, отрисовку, которую он ждёт, и операции, чувствительные ко времени. Для них правило советует оставлять синхронный код.

Исходный текст

js-request-idle-callback.md · MIT
---
title: Defer Non-Critical Work with requestIdleCallback
impact: MEDIUM
impactDescription: keeps UI responsive during background tasks
tags: javascript, performance, idle, scheduling, analytics
---

## Defer Non-Critical Work with requestIdleCallback

**Impact: MEDIUM (keeps UI responsive during background tasks)**

Use `requestIdleCallback()` to schedule non-critical work during browser idle periods. This keeps the main thread free for user interactions and animations, reducing jank and improving perceived performance.

**Incorrect (blocks main thread during user interaction):**

```typescript
function handleSearch(query: string) {
  const results = searchItems(query)
  setResults(results)

  // These block the main thread immediately
  analytics.track('search', { query })
  saveToRecentSearches(query)
  prefetchTopResults(results.slice(0, 3))
}
```

**Correct (defers non-critical work to idle time):**

```typescript
function handleSearch(query: string) {
  const results = searchItems(query)
  setResults(results)

  // Defer non-critical work to idle periods
  requestIdleCallback(() => {
    analytics.track('search', { query })
  })

  requestIdleCallback(() => {
    saveToRecentSearches(query)
  })

  requestIdleCallback(() => {
    prefetchTopResults(results.slice(0, 3))
  })
}
```

**With timeout for required work:**

```typescript
// Ensure analytics fires within 2 seconds even if browser stays busy
requestIdleCallback(
  () => analytics.track('page_view', { path: location.pathname }),
  { timeout: 2000 }
)
```

**Chunking large tasks:**

```typescript
function processLargeDataset(items: Item[]) {
  let index = 0

  function processChunk(deadline: IdleDeadline) {
    // Process items while we have idle time (aim for <50ms chunks)
    while (index < items.length && deadline.timeRemaining() > 0) {
      processItem(items[index])
      index++
    }

    // Schedule next chunk if more items remain
    if (index < items.length) {
      requestIdleCallback(processChunk)
    }
  }

  requestIdleCallback(processChunk)
}
```

**With fallback for unsupported browsers:**

```typescript
const scheduleIdleWork = window.requestIdleCallback ?? ((cb: () => void) => setTimeout(cb, 1))

scheduleIdleWork(() => {
  // Non-critical work
})
```

**When to use:**

- Analytics and telemetry
- Saving state to localStorage/IndexedDB
- Prefetching resources for likely next actions
- Processing non-urgent data transformations
- Lazy initialization of non-critical features

**When NOT to use:**

- User-initiated actions that need immediate feedback
- Rendering updates the user is waiting for
- Time-sensitive operations

© fcakyon · MIT · fcakyon/claude-codex-settings

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

Все правила IDE по теме «Фронтенд и UI» →
js-performance-patterns patterns.dev Скилл js-performance-patterns для Claude Code помогает устранять просадки скорости в горячих путях JavaScript: в циклах, обработчиках событий и операциях с DOM. CX Codex +1 716установок frontend-js-best-practices sergiodxa Скилл frontend-js-best-practices задаёт 17 правил оптимизации и стиля для JavaScript и TypeScript. Помогает писать быстрые циклы, избегать лишних аллокаций и убирать мутации массивов при рефакторинге. CX Codex +1 341установок integration-javascript_web PostHog Скилл integration-javascript_web помогает встроить клиентскую веб-аналитику PostHog на базе библиотеки posthog-js в браузерное приложение. CX Codex +1 125установок language-detector-api webmaxru Помогает подключить встроенный Language Detector API в веб-приложении на JavaScript или TypeScript: проверки поддержки, скачивание модели, сессии и detect(). CX Codex +1 518установок proofreader-api webmaxru Проверяет доступность Proofreader API, загружает модель и разбирает правки в браузерном веб-приложении. CX Codex +1 513установок js-min-max-loop jarrodwatts Правило js-min-max-loop требует искать минимум и максимум в массиве одним циклом вместо сортировки. Помогает избежать вычислений O(n log n) и лишнего копирования данных. CX Codex +1 ★ 1 064звёзд репо

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

Весь набор →
rendering-resource-hints Правило rendering-resource-hints учит агента вставлять в React-компоненты вызовы API React DOM для подсказок браузеру о ресурсах. Встраивается в серверные компоненты, чтобы загрузка файлов стартовала раньше, чем клиент получит HTML. CX Codex +1 ★ 1 216звёзд репо animation-gesture-detector-press Правило animation-gesture-detector-press для Claude Code переносит анимацию нажатия кнопки React Native в UI-поток, без перехода в JS. Меняет масштаб или прозрачность при нажатии. CX Codex +1 ★ 1 216звёзд репо commit-staged Скилл commit-staged формирует структурированные коммиты: прогоняет diff через /simplify, смотрит только staged-файлы и собирает понятные сообщения из контекста сессии. CX Codex +1 ★ 1 216звёзд репо shell-and-workflows Правило shell-and-workflows описывает работу с Docker-сервисами проекта, типовые команды и порядок запуска тестов. Помогает выбрать, где выполнять фронтенд- и бэкенд-проверки. CX Codex +1 ★ 1 216звёзд репо pr-comment-resolver Субагент pr-comment-resolver находит неразрешённые замечания в пуллреквесте, исправляет код и готовит черновики ответов рецензентам. Помогает закрыть ревью без ручного разбора тредов. CX Codex ★ 1 216звёзд репо list-performance-item-types Правило list-performance-item-types для Claude Code задаёт типы элементов в списках с разной разметкой. Оно подключается при работе с такими списками и настраивает раздельное переиспользование компонентов. CX Codex +1 ★ 1 216звёзд репо manage-instances Правило manage-instances для параллельного запуска нескольких изолированных стеков приложения в отдельных worktree, каждый со своей БД, Redis и портами. CX Codex +1 ★ 1 216звёзд репо test-audit Скилл test-audit проверяет новые и изменённые тесты, а также помогает находить дубли и низкоценные проверки. Пригодится перед добавлением тестов и при аудите тестового набора. CX Codex +1 ★ 1 216звёзд репо

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

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