Что такое гидратация — и почему страница уже видна, но кнопки ещё не нажимаются

Знакомая сцена: страница открылась, всё нарисовано, ты жмёшь кнопку — и ничего. Жмёшь ещё раз. Через секунду она вдруг срабатывает дважды.
Ты не тормозишь и интернет не виноват. Ты попал в окно гидратации — промежуток, когда картинка страницы уже есть, а «проводка» к ней ещё не подключена. Штука неочевидная: обычно мы думаем, что «видно» и «работает» приезжают вместе. Тут они приезжают по отдельности, и между ними есть щель.
Что такое гидратация в одной фразе
Сервер отдаёт браузеру готовый HTML — текст, заголовки, картинки, кнопки. Человек видит страницу почти сразу, ещё до того, как загрузится хоть строчка JavaScript.
Но этот HTML мёртвый. Кнопка нарисована, а что она должна делать при нажатии — в нём не записано. Логика лежит отдельно, в JavaScript-файле.
Гидратация — это момент, когда скачанный JavaScript находит уже нарисованные элементы и «прикрепляется» к ним, беря управление на себя. Документация React описывает это буквально так: гидратация превращает первоначальный HTML-снимок с сервера в полноценное интерактивное приложение.
Аналогия простая: сервер прислал готовую квартиру с выключателями на стенах. Гидратация — это электрик, который подводит к ним провода. До его приезда выключатели есть, а свет не включается.
Откуда берётся «мёртвое окно»
Между «видно» и «работает» браузеру нужно успеть:
- Скачать JavaScript-бандл (обычно он в разы тяжелее самого HTML).
- Разобрать и выполнить его — а это работа для процессора, не для сети.
- Пройти по дереву элементов и навесить обработчики.
На твоём ноутбуке это занимает миллисекунды и незаметно. На бюджетном телефоне пятилетней давности шаг 2 растягивается, и окно превращается в ощутимую паузу. Отсюда парадокс: чем больше кода ты добавил ради «удобства», тем дольше страница остаётся картинкой.
Именно это окно портит метрику INP — «сколько прошло от нажатия до изменения на экране». Подробнее про неё — в разборе Core Web Vitals.
Хуже всего, что для человека окно невидимо: страница выглядит абсолютно готовой. Никакого индикатора «подожди, я ещё подключаюсь» по умолчанию нет.
Ошибка несовпадения — и почему её нельзя игнорировать
Второй сюрприз. Чтобы прикрепиться к элементам, JavaScript должен нарисовать в памяти ровно то же самое, что прислал сервер. Если результат отличается хоть на символ — это несовпадение (hydration mismatch).
Документация React формулирует жёстко: содержимое обязано быть идентичным серверному, а несовпадения нужно считать багами и чинить. И дальше самое интересное — React не сверяет всю разметку целиком: в доках прямо сказано, что проверять всё было бы непозволительно дорого, поэтому гарантий, что расхождения в атрибутах будут подлатаны, нет. А несовпавший текст он чинить и не пытается.
То есть часть расхождений просто останется в странице и будет тихо портить поведение.
Классические причины, которые перечисляет сама документация:
- Лишние пробелы и переносы вокруг разметки, которую генерирует React.
- Проверки вида «а есть ли у нас окно браузера» прямо в рендере.
- Обращение к браузерным API там, где сервер их не имеет.
- Разные данные на сервере и на клиенте — текущее время, случайное число, локальный формат даты.
Последний пункт — самый частый. Сервер отрисовал «14:03», браузер через секунду отрисовал «14:04» — и всё разъехалось.
Что с этим делать на практике
- Не выводи «сейчас» прямо в разметке. Отрисуй заглушку, а живое время подставь после того, как компонент уже смонтировался.
- Не завись от размера экрана в рендере. Сервер не знает ширину окна и всегда угадает неправильно.
- Читай ошибку в консоли, а не глуши её. У React есть точечное подавление предупреждения для случаев вроде таймстемпа, но это аварийный люк на один уровень вложенности, не решение.
- Меньше кода — меньше окно. Если блок статичный (текст, картинка, футер), ему не нужен JavaScript вообще. Самая надёжная оптимизация гидратации — не гидратировать то, что не кликается.
Гидратация — это только про React?
Нет. Так работает любой фреймворк, который рисует HTML на сервере, а интерактивность добавляет в браузере — React, Vue, Svelte и надстройки над ними. Слово одно, механика одна: сначала разметка, потом провода к DOM.
Как понять, что мёртвое окно есть именно у меня?
Открой сайт на телефоне и попробуй нажать кнопку сразу, как только увидел её. Если первое нажатие проглатывается — окно есть. Второй способ: в инструментах разработчика включить замедление процессора вчетверо и повторить.
Гидратация замедляет сайт?
Она не бесплатна: браузер повторяет часть работы, уже сделанной сервером. Зато человек видит содержимое до того, как приедет JavaScript. Обмен обычно выгодный — но только пока бандл не разросся.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





