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

js-hoist-regexp — правило для Claude Code: что делает и как установить

Правило js-hoist-regexp для Claude про регулярки в React: шаблон не создаётся внутри рендера, а живёт в модуле или в useMemo().

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

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

Что делает js-hoist-regexp

Правило про одну привычку в React-коде: регулярка не должна создаваться внутри рендера. Либо константа на уровне модуля, либо useMemo() с зависимостью от строки запроса.

В файле разобраны два варианта одного компонента. В первом new RegExp(...) стоит прямо в теле функции, во втором тот же вызов завёрнут в useMemo и пересобирается только при смене query. Для шаблонов, которые не меняются между рендерами, показана константа вида EMAIL_REGEX на уровне модуля. Эффект помечен как LOW-MEDIUM — правка мелкая, но заметная на списках и подсветке.

Отдельное предупреждение касается флага g. У глобальной регулярки есть изменяемое поле lastIndex, поэтому второй test на той же строке вернёт уже false. Вынос в модуль это состояние не убирает: оно переезжает вместе с регуляркой.

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

  • убрать пересоздание регулярки на каждом рендере компонента
  • заменить new RegExp в теле функции на константу модуля
  • обернуть динамическую регулярку в useMemo() с зависимостью от запроса
  • разобраться, почему повторный test на той же строке даёт другой ответ

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

  • В компоненте Highlighter регулярка создаётся внутри рендера — вынеси её в модуль или оберни в useMemo().
  • Проверь search.tsx на new RegExp в теле компонента и предложи вариант с мемоизацией.
  • Найди глобальные регулярки с флагом g, которые переиспользуются между вызовами, и объясни, что с ними происходит из-за lastIndex.

Как установить js-hoist-regexp

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

.claude/rules/js-hoist-regexp.md

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

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

Вопросы о js-hoist-regexp

Как установить js-hoist-regexp в Claude Code?

Скопируйте файл правила в проект по пути .claude/rules/js-hoist-regexp.md.

Что делает js-hoist-regexp?

Запрещает собирать регулярку во время рендера. Шаблон выносят на уровень модуля или кэшируют через useMemo() по строке запроса.

Почему глобальная регулярка ведёт себя по-разному на одной и той же строке?

У шаблона с флагом g хранится lastIndex, и следующий test продолжает с прошлой позиции. В примере первый вызов возвращает true, второй на той же строке — false.

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

js-hoist-regexp.md · MIT
---
title: Hoist RegExp Creation
impact: LOW-MEDIUM
impactDescription: avoids recreation
tags: javascript, regexp, optimization, memoization
---

## Hoist RegExp Creation

Don't create RegExp inside render. Hoist to module scope or memoize with `useMemo()`.

**Incorrect (new RegExp every render):**

```tsx
function Highlighter({ text, query }: Props) {
  const regex = new RegExp(`(${query})`, 'gi')
  const parts = text.split(regex)
  return <>{parts.map((part, i) => ...)}</>
}
```

**Correct (memoize or hoist):**

```tsx
const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/

function Highlighter({ text, query }: Props) {
  const regex = useMemo(
    () => new RegExp(`(${escapeRegex(query)})`, 'gi'),
    [query]
  )
  const parts = text.split(regex)
  return <>{parts.map((part, i) => ...)}</>
}
```

**Warning (global regex has mutable state):**

Global regex (`/g`) has mutable `lastIndex` state:

```typescript
const regex = /foo/g
regex.test('foo')  // true, lastIndex = 3
regex.test('foo')  // false, lastIndex = 0
```

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

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

Все правила IDE по теме «Фронтенд и UI» →
react-patterns manutej Скилл react-patterns для Claude Code учит агента современным паттернам React: хукам, композиции компонентов и управлению состоянием. Охватывает React 18+, Server Components и мемоизацию. CX Codex +1 474установок react-render-optimization patterns.dev Скилл react-render-optimization для Claude Code и ещё пяти агентов учит убирать лишние ре-рендеры в React. Пригодится при рефакторинге компонентов, которые тормозят на вводе, скролле и любых взаимодействиях. CX Codex +1 1 200установок react-coding-style LegendApp Скилл react-coding-style для ИИ-агента: помогает писать и ревьюить React-код с узкими подписками, стабильными идентичностями и честными зависимостями хуков. CX Codex +1 482установок js-hoist-intl alexj11324 js-hoist-intl — правило для Claude Code, которое убирает создание форматтеров Intl из рендеров и циклов. Оно применяется при работе с JavaScript-кодом, где форматируют даты, числа или относительное время. CX Codex +1 ★ 88звёзд репо react-performance oakoss Скилл react-performance для Claude Code собирает паттерны оптимизации React и включается автоматически в задачах о скорости приложения. CX Codex +1 163установок js-performance-patterns patterns.dev Скилл js-performance-patterns для Claude Code помогает устранять просадки скорости в горячих путях JavaScript: в циклах, обработчиках событий и операциях с DOM. CX Codex +1 716установок

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

Весь набор →
rerender-defer-reads Правило rerender-defer-reads подсказывает читать динамическое состояние в момент действия, если компонент использует его только внутри callback. Это сокращает лишние подписки. CX Codex +1 ★ 7 191звёзд репо rendering-conditional-render Правило rendering-conditional-render предотвращает случайный рендер нулей и NaN в JSX. Использует явные тернарные операторы вместо && для проверок, чтобы falsy-значения не попадали в DOM. CX Codex +1 ★ 7 191звёзд репо server-serialization Правило server-serialization для Claude Code помогает сокращать данные, которые React передаёт с сервера на клиент. Оно срабатывает при работе с границей Server/Client в React. CX Codex +1 ★ 7 191звёзд репо rerender-simple-expression-in-memo Правило rerender-simple-expression-in-memo помогает не оборачивать простые выражения с результатом типа boolean, number или string в useMemo. Пригодится при работе с React-компонентами. CX Codex +1 ★ 7 191звёзд репо rendering-hoist-jsx Правило rendering-hoist-jsx выносит неизменяемые JSX-элементы за пределы компонентов, чтобы они не создавались заново при каждом рендере. CX Codex +1 ★ 7 191звёзд репо rerender-transitions Правило rerender-transitions для Claude Code предлагает выносить частые несрочные обновления состояния React-интерфейса в transitions. Для значения прокрутки в обработчике scroll обновление выполняется как несрочное. CX Codex +1 ★ 7 191звёзд репо advanced-use-latest Правило advanced-use-latest для Claude показывает, как в эффектах React брать свежий колбэк, не добавляя его в массив зависимостей. CX Codex +1 ★ 7 191звёзд репо async-api-routes Правило async-api-routes устраняет цепочки водопадов в обработчиках API и Server Actions. Оно запускает независимые асинхронные вызовы сразу, не дожидаясь завершения других промисов. CX Codex +1 ★ 7 191звёзд репо

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

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