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

rendering-hydration-suppress-warning — правило

Правило rendering-hydration-suppress-warning гасит предупреждения гидратации там, где сервер и клиент намеренно показывают разное: даты, случайные ID, форматирование по локали.

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

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

Что делает rendering-hydration-suppress-warning

Правило разбирает случай, когда в SSR-приложении сервер и клиент законно выдают разную разметку: метка времени, случайный ID, форматирование по локали и часовому поясу. Такие расхождения предлагается не искать, а обернуть динамический текст в элемент с suppressHydrationWarning.

Внутри один markdown-файл: короткое объяснение и два примера на TSX. Первый — компонент Timestamp, который печатает new Date().toLocaleString() и получает предупреждение гидратации. Второй — тот же компонент с атрибутом на span.

Атрибут глушит вывод, а не чинит причину. Правило прямо говорит не прятать за ним настоящие баги и не ставить его везде подряд. Если не можешь объяснить, почему два рендера расходятся, suppressHydrationWarning только отложит разбор. Файл кладут в .claude/rules/rendering-hydration-suppress-warning.md.

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

  • Убрать шум гидратации от метки времени, которая по задумке разная на сервере и клиенте
  • Оставить в консоли только настоящие расхождения разметки
  • Обернуть случайный ID в элемент с suppressHydrationWarning
  • Объяснить на ревью, почему атрибут стоит именно на этом узле

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

  • Найди в Timestamp расхождение гидратации из-за new Date() и оберни вывод в suppressHydrationWarning.
  • Проверь, где у нас suppressHydrationWarning прикрывает настоящий баг, а не разницу локали.
  • Добавь в проект правило .claude/rules/rendering-hydration-suppress-warning.md.

Как установить rendering-hydration-suppress-warning

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

.claude/rules/rendering-hydration-suppress-warning.md

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

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

Вопросы о rendering-hydration-suppress-warning

Как установить rendering-hydration-suppress-warning в Claude Code?

Положи файл правила в проект по пути .claude/rules/rendering-hydration-suppress-warning.md. Больше ничего делать не нужно: это обычный markdown.

Что делает rendering-hydration-suppress-warning?

Описывает, когда расхождение серверной и клиентской разметки ожидаемо, и показывает, как обернуть такой текст в элемент с suppressHydrationWarning.

Можно ли ставить suppressHydrationWarning на любое расхождение?

Нет. Правило оставляет атрибут для известных различий вроде дат и локали, а настоящие баги советует искать, а не глушить.

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

rendering-hydration-suppress-warning.md · MIT
---
title: Suppress Expected Hydration Mismatches
impact: LOW-MEDIUM
impactDescription: avoids noisy hydration warnings for known differences
tags: rendering, hydration, ssr, nextjs
---

## Suppress Expected Hydration Mismatches

In SSR frameworks (e.g., Next.js), some values are intentionally different on server vs client (random IDs, dates, locale/timezone formatting). For these *expected* mismatches, wrap the dynamic text in an element with `suppressHydrationWarning` to prevent noisy warnings. Do not use this to hide real bugs. Don’t overuse it.

**Incorrect (known mismatch warnings):**

```tsx
function Timestamp() {
  return <span>{new Date().toLocaleString()}</span>
}
```

**Correct (suppress expected mismatch only):**

```tsx
function Timestamp() {
  return (
    <span suppressHydrationWarning>
      {new Date().toLocaleString()}
    </span>
  )
}
```

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

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

Все правила IDE по теме «Фронтенд и UI» →
progressive-hydration patterns.dev Скилл progressive-hydration для Claude Code помогает распределить клиентскую гидратацию по приоритету. Он подключается при работе с SSR-страницами, где части интерфейса могут ждать JavaScript. CX Codex +1 1 000установок hydration-guardian oakoss Скилл hydration-guardian ловит расхождение серверной разметки и клиентского React-дерева: по тексту ошибки находит причину и подсказывает, какой приём гидратации применить. CX Codex +1 144установок react-selective-hydration patterns.dev Скилл react-selective-hydration для Claude Code учит агента настраивать выборочную гидратацию и потоковый SSR в React 18+. Ускоряет интерактивность страниц с тяжёлыми компонентами и запросами данных. CX Codex +1 1 000установок execution-model TanStack Скилл execution-model помогает агенту правильно разделять серверный и клиентский код в TanStack Start и учитывать SSR, гидрацию и переменные окружения. CX Codex +1 214установок react-best-practices vercel Скилл react-best-practices для разбора медленного интерфейса на React и Next.js: находит водопады запросов, лишний JS в бандле, ошибки на границе сервер-клиент и пустые ререндеры. CX Codex +1 401установок next-best-practices laguagu Скилл next-best-practices для Claude Code подсказывает практики Next.js App Router при написании и проверке кода. Помогает разбирать ошибки гидратации, границы RSC и проблемы с данными. CX Codex +1 286установок

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

Весь набор →
decomposition-planning-roadmap Скилл decomposition-planning-roadmap для Claude Code создаёт план декомпозиции монолита и дорожную карту миграции. Он подключается к задачам по выбору порядка выделения сервисов и отслеживанию работ. CX Codex +1 322установок seo Прогоняет сайт по чек-листу технического и on-page SEO: обход, canonical, sitemap, метатеги, разметка JSON-LD. Устраняет проблемы с индексацией и кривыми сниппетами в выдаче. CX Codex +1 ★ 7 191звёзд репо best-practices Скилл best-practices для Claude Code проверяет веб-код на проблемы безопасности, совместимости с браузерами и качества. Запускается по запросу на аудит или модернизацию кода. CX Codex +1 ★ 7 191звёзд репо js-index-maps Правило js-index-maps заменяет повторные .find() по одному ключу на индекс Map. Оно пригодится при частых поисках в массивах. CX Codex +1 ★ 7 191звёзд репо bundle-defer-third-party Правило bundle-defer-third-party запрещает прямо импортировать сторонние трекеры в начальный бандл. Агент оборачивает аналитику и логирование в динамическую загрузку после гидратации. CX Codex +1 ★ 7 191звёзд репо bundle-conditional Правило bundle-conditional предлагает загружать крупные модули только при активации функции. Оно пригодится для отложенной загрузки данных и сокращения серверного бандла при SSR. CX Codex +1 ★ 7 191звёзд репо react19-no-forwardref Правило react19-no-forwardref напоминает о двух ключевых изменениях в React 19: ref теперь обычный проп (без forwardRef), а use() заменяет useContext(). Подходит для проектов, переходящих на React 19. CX Codex +1 ★ 7 191звёзд репо advanced-init-once Правило advanced-init-once запрещает запускать глобальную инициализацию приложения в useEffect([]) компонентов и предлагает использовать флаг на уровне модуля или код в точке входа. CX Codex +1 ★ 7 191звёзд репо

Ещё в каталоге

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

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