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