js-request-idle-callback — правило для Claude Code
Правило js-request-idle-callback учит агента уводить аналитику, сохранение состояния и предзагрузку в простой браузера, чтобы интерфейс не подвисал на кликах.
MIT ★ 1 216 обновлён 2026-10-24
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settingsЧто делает 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-settings2Вручную: положить файлы
.claude/rules/js-request-idle-callback.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/js-request-idle-callback.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/js-request-idle-callback.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/js-request-idle-callback.mdВручную: положить файлы
.clinerules/js-request-idle-callback.mdПо шагам, с командами для каждой платформы: 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