Что такое…

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

Иллюстрация: макет страницы стоит целиком, а провода к кнопкам ещё тянут снизу

Знакомая сцена: страница открылась, всё нарисовано, ты жмёшь кнопку — и ничего. Жмёшь ещё раз. Через секунду она вдруг срабатывает дважды.

Ты не тормозишь и интернет не виноват. Ты попал в окно гидратации — промежуток, когда картинка страницы уже есть, а «проводка» к ней ещё не подключена. Штука неочевидная: обычно мы думаем, что «видно» и «работает» приезжают вместе. Тут они приезжают по отдельности, и между ними есть щель.

Что такое гидратация в одной фразе

Сервер отдаёт браузеру готовый HTML — текст, заголовки, картинки, кнопки. Человек видит страницу почти сразу, ещё до того, как загрузится хоть строчка JavaScript.

Но этот HTML мёртвый. Кнопка нарисована, а что она должна делать при нажатии — в нём не записано. Логика лежит отдельно, в JavaScript-файле.

Гидратация — это момент, когда скачанный JavaScript находит уже нарисованные элементы и «прикрепляется» к ним, беря управление на себя. Документация React описывает это буквально так: гидратация превращает первоначальный HTML-снимок с сервера в полноценное интерактивное приложение.

Аналогия простая: сервер прислал готовую квартиру с выключателями на стенах. Гидратация — это электрик, который подводит к ним провода. До его приезда выключатели есть, а свет не включается.

Откуда берётся «мёртвое окно»

Между «видно» и «работает» браузеру нужно успеть:

  1. Скачать JavaScript-бандл (обычно он в разы тяжелее самого HTML).
  2. Разобрать и выполнить его — а это работа для процессора, не для сети.
  3. Пройти по дереву элементов и навесить обработчики.

На твоём ноутбуке это занимает миллисекунды и незаметно. На бюджетном телефоне пятилетней давности шаг 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 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →