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