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

js-tosorted-immutable — правило для Claude Code

Правило js-tosorted-immutable заменяет мутирующий .sort() на .toSorted(), чтобы сортировка не меняла массивы в props и state React.

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

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

Что делает 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 и 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

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

Все правила IDE по теме «Фронтенд и UI» →
kotlin-tooling-immutable-collections-0-5-x-migration JetBrains Скилл kotlin-tooling-immutable-collections-0-5-x-migration для Claude Code переносит Kotlin- и Java-код с kotlinx.collections.immutable 0.3.x и 0.4.x на 0.5.x, переименовывая методы по подсказкам компилятора. CX Codex +1 1 300установок seeker-connect solana-mobile Скилл seeker-connect подключает веб-, React Native- и Kotlin-приложения к встроенному кошельку на телефоне Seeker: вход через Solana, подпись сообщений и транзакций. CX Codex +1 9 700установок meticulous-cli alwaysmeticulous Скилл meticulous-cli обучает агента работать с CLI-утилитой Meticulous: запускать воспроизведение сессий, проверять визуальные регрессии и управлять авторизацией. CX Codex +1 9 200установок meticulous-test alwaysmeticulous Скилл meticulous-test запускает прогон Meticulous после правок во фронтенде и передаёт результат скиллу meticulous-review, чтобы разметить каждое визуальное изменение. CX Codex +1 9 100установок emblem-ai-react EmblemAI Скилл emblem-ai-react для Claude Code добавляет React-приложениям аутентификацию через кошельки, email и соцсети плюс хуки EmblemAI. Врубается, когда нужен EmblemAuthProvider, кнопка подключения или чат-компоненты. CX Codex +1 8 800установок emblem-ai EmblemCompany Скилл emblem-ai добавляет в приложение вход через кошелёк, email или соцсети и даёт каждому пользователю кошелёк вместе с аккаунтом. Плюс готовый чат-компонент и отладка работающего приложения. CX Codex +1 8 700установок

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

Весь набор →
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-length-check-first Правило js-length-check-first для Claude Code, которое подсказывает проверять длину массивов перед дорогими операциями вроде сортировки или глубокого сравнения. Если длины не совпадают, массивы точно не равны — операция не нужна. 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звёзд репо client-event-listeners Правило client-event-listeners для Claude сводит глобальные подписки к одному слушателю: сколько бы компонентов ни вызывало хук, window получает один обработчик keydown. CX Codex +1 ★ 7 191звёзд репо

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

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