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

js-length-check-first — правило для Claude Code

Правило js-length-check-first для Claude Code, которое подсказывает проверять длину массивов перед дорогими операциями вроде сортировки или глубокого сравнения. Если длины не совпадают, массивы точно не равны — операция не нужна.

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

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

Что делает js-length-check-first

Правило срабатывает в горячих путях кода: обработчиках событий, циклах отрисовки, функциях сравнения, которые вызываются часто. Вместо того чтобы запускать O(n log n) сортировку на двух массивах, проверка current.length !== original.length завершается за O(1) и сразу возвращает результат, если длины не совпадают.

Внутри правила — примеры неправильного и правильного подхода на TypeScript. Неправильный сортирует и соединяет массивы при любых длинах, теряя время и память. Правильный проверяет длину в первую очередь, потом сортирует только если длины совпадают, и сравнивает элементы циклом, чтобы выйти при первом отличии.

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

  • избежать сортировки и join() когда массивы разной длины
  • ускорить сравнение массивов в обработчиках событий
  • снизить потребление памяти при работе с большими массивами
  • вернуть результат за O(1) вместо O(n log n)

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

  • Сравни два массива строк и скажи, изменились ли они, без лишних операций
  • Напиши функцию, которая проверяет, одинаковы ли два списка, сначала по размеру
  • Оптимизируй сравнение массивов так, чтобы не сортировать, если длины не совпадают

Как установить js-length-check-first

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

.claude/rules/js-length-check-first.md

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

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

Вопросы о js-length-check-first

Как установить js-length-check-first в Claude Code?

Скопируй файл правила в папку .claude/rules/ своего проекта с именем js-length-check-first.md. Claude Code подхватит правило автоматически при следующем запуске.

Что делает это правило?

Оно учит генератор кода проверять длину массивов перед дорогими операциями вроде сортировки или глубокого сравнения. Если длины не совпадают, операция ненужна и можно вернуть ответ сразу.

Когда это правило особенно полезно?

Оно важно в горячих путях — обработчиках событий, циклах отрисовки, функциях, которые вызываются сотни раз в секунду. На больших массивах экономия может быть существенной.

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

js-length-check-first.md · MIT
---
title: Early Length Check for Array Comparisons
impact: MEDIUM-HIGH
impactDescription: avoids expensive operations when lengths differ
tags: javascript, arrays, performance, optimization, comparison
---

## Early Length Check for Array Comparisons

When comparing arrays with expensive operations (sorting, deep equality, serialization), check lengths first. If lengths differ, the arrays cannot be equal.

In real-world applications, this optimization is especially valuable when the comparison runs in hot paths (event handlers, render loops).

**Incorrect (always runs expensive comparison):**

```typescript
function hasChanges(current: string[], original: string[]) {
  // Always sorts and joins, even when lengths differ
  return current.sort().join() !== original.sort().join()
}
```

Two O(n log n) sorts run even when `current.length` is 5 and `original.length` is 100. There is also overhead of joining the arrays and comparing the strings.

**Correct (O(1) length check first):**

```typescript
function hasChanges(current: string[], original: string[]) {
  // Early return if lengths differ
  if (current.length !== original.length) {
    return true
  }
  // Only sort when lengths match
  const currentSorted = current.toSorted()
  const originalSorted = original.toSorted()
  for (let i = 0; i < currentSorted.length; i++) {
    if (currentSorted[i] !== originalSorted[i]) {
      return true
    }
  }
  return false
}
```

This new approach is more efficient because:
- It avoids the overhead of sorting and joining the arrays when lengths differ
- It avoids consuming memory for the joined strings (especially important for large arrays)
- It avoids mutating the original arrays
- It returns early when a difference is found

© tech-leads-club · MIT · tech-leads-club/agent-skills

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

Все правила IDE по теме «Код-ревью и рефакторинг» →
js-combine-iterations jarrodwatts Правило js-combine-iterations учит агента Claude заменять несколько filter/map по одному массиву одним циклом с накопителями — когда проходов стало слишком много. CX Codex +1 ★ 1 064звёзд репо js-performance-patterns patterns.dev Скилл js-performance-patterns для Claude Code помогает устранять просадки скорости в горячих путях JavaScript: в циклах, обработчиках событий и операциях с DOM. CX Codex +1 716установок check-best-practices centminmod Команда check-best-practices проверяет код на соответствие языковым стандартам, конвенциям и best practices. Помогает улучшить качество и поддерживаемость кода, выявляя проблемы от критических до стилистических. CX Codex +1 ★ 2 744звёзд репо frontend-js-best-practices sergiodxa Скилл frontend-js-best-practices задаёт 17 правил оптимизации и стиля для JavaScript и TypeScript. Помогает писать быстрые циклы, избегать лишних аллокаций и убирать мутации массивов при рефакторинге. CX Codex +1 341установок third-party patterns.dev Скилл third-party для Claude Code, Codex, Cursor и других платформ, учит снижать влияние сторонних скриптов на производительность. Запускается при работе с аналитикой, рекламой, виджетами чатов или встраиваемыми картами. CX Codex +1 1 700установок

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

Весь набор →
_sections Правило _sections для Claude Code, которое определяет восемь разделов оптимизации производительности, их приоритеты и порядок применения. Устанавливается один раз в проект и служит справочником при анализе кода агентом. CX Codex +1 ★ 7 191звёзд репо client-passive-event-listeners Правило client-passive-event-listeners учит агента добавлять { passive: true } к обработчикам событий скролла и тача, чтобы браузер не задерживал прокрутку страницы. CX Codex +1 ★ 7 191звёзд репо js-cache-storage Правило js-cache-storage требует держать значения localStorage, sessionStorage и cookie в памяти, а не дёргать синхронное хранилище на каждом вызове. CX Codex +1 ★ 7 191звёзд репо rerender-use-ref-transient-values Правило rerender-use-ref-transient-values учит агента хранить часто меняющиеся значения в useRef, а не в useState, чтобы избежать перерисовок компонента на каждое обновление. CX Codex +1 ★ 7 191звёзд репо 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звёзд репо

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

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