js-tosorted-immutable — правило для Claude Code
Правило js-tosorted-immutable заменяет мутирующий .sort() на .toSorted(), чтобы сортировка не меняла массивы в props и state React.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/js-tosorted-immutable.mdЧто делает js-tosorted-immutable
Правило просит использовать .toSorted() вместо .sort(). Первый меняет копию и оставляет исходный массив прежним, а второй сортирует массив на месте. Это важно для компонентов React, где props и state должны оставаться неизменяемыми.
Такой подход также снижает риск ошибок в callback и effect, когда изменённый массив сохраняется в замыкании. Для старых браузеров и сред ниже Node.js 20 понадобится запасной вариант: [...items].sort((a, b) => a.value - b.value). В проекте с Node.js 20+ доступен .toSorted().
Какие задачи решает
- заменить мутацию массива при сортировке
- сохранить props React неизменяемыми
- избежать устаревших данных в замыканиях
- переписать сортировку списка пользователей
Примеры запросов агенту
- Проверь код React и замени
.sort()на безопасный вариант без изменения исходного массива. - Перепиши сортировку
usersтак, чтобы props не мутировались. - Проверь, нужен ли fallback для
.toSorted()в этом проекте.
Как установить js-tosorted-immutable
Вручную: положить файлы
.claude/rules/js-tosorted-immutable.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/js-tosorted-immutable.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/js-tosorted-immutable.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/js-tosorted-immutable.mdВручную: положить файлы
.clinerules/js-tosorted-immutable.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о js-tosorted-immutable
Как установить js-tosorted-immutable в Claude Code?
Поместите файл .claude/rules/js-tosorted-immutable.md в проект.
Что делает js-tosorted-immutable?
Правило рекомендует .toSorted() вместо .sort(), чтобы сортировка создавала новый массив и не меняла исходный. Оно особенно относится к props и state React.
Что использовать в старых браузерах?
Для старых сред используйте копирование через spread и затем .sort(): [...items].sort((a, b) => a.value - b.value). .toSorted() доступен в Chrome 110+, Safari 16+, Firefox 115+ и Node.js 20+.
Исходный текст
js-tosorted-immutable.md · MIT
---
title: Use toSorted() Instead of sort() for Immutability
impact: MEDIUM-HIGH
impactDescription: prevents mutation bugs in React state
tags: javascript, arrays, immutability, react, state, mutation
---
## Use toSorted() Instead of sort() for Immutability
`.sort()` mutates the array in place, which can cause bugs with React state and props. Use `.toSorted()` to create a new sorted array without mutation.
**Incorrect (mutates original array):**
```typescript
function UserList({ users }: { users: User[] }) {
// Mutates the users prop array!
const sorted = useMemo(
() => users.sort((a, b) => a.name.localeCompare(b.name)),
[users]
)
return <div>{sorted.map(renderUser)}</div>
}
```
**Correct (creates new array):**
```typescript
function UserList({ users }: { users: User[] }) {
// Creates new sorted array, original unchanged
const sorted = useMemo(
() => users.toSorted((a, b) => a.name.localeCompare(b.name)),
[users]
)
return <div>{sorted.map(renderUser)}</div>
}
```
**Why this matters in React:**
1. Props/state mutations break React's immutability model - React expects props and state to be treated as read-only
2. Causes stale closure bugs - Mutating arrays inside closures (callbacks, effects) can lead to unexpected behavior
**Browser support (fallback for older browsers):**
`.toSorted()` is available in all modern browsers (Chrome 110+, Safari 16+, Firefox 115+, Node.js 20+). For older environments, use spread operator:
```typescript
// Fallback for older browsers
const sorted = [...items].sort((a, b) => a.value - b.value)
```
**Other immutable array methods:**
- `.toSorted()` - immutable sort
- `.toReversed()` - immutable reverse
- `.toSpliced()` - immutable splice
- `.with()` - immutable element replacement
© tech-leads-club · MIT · tech-leads-club/agent-skills