js-length-check-first — правило для Claude Code
Правило js-length-check-first для Claude Code, которое подсказывает проверять длину массивов перед дорогими операциями вроде сортировки или глубокого сравнения. Если длины не совпадают, массивы точно не равны — операция не нужна.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/js-length-check-first.mdЧто делает 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
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/js-length-check-first.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/js-length-check-first.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/js-length-check-first.mdВручную: положить файлы
.clinerules/js-length-check-first.mdПо шагам, с командами для каждой платформы: 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