Next.js «use client»: когда нужен, а когда лишний
В Next.js директива «use client» нужна только в трёх случаях: компонент использует хуки вроде useState или useEffect, обрабатывает события вроде onClick или onChange либо обращается к возможностям браузера — window, localStorage. Всё остальное лучше оставить на сервере. Ставьте директиву не на всю страницу, а на небольшой интерактивный компонент.
Что на самом деле делает «use client»?
В App Router компоненты по умолчанию работают на сервере: они приходят в виде HTML и не отправляют свой код в браузер. Директива «use client» в начале файла проводит границу между сервером и клиентом. Этот файл и всё, что он импортирует, загружается в браузер как JavaScript.
Важная деталь: клиентский компонент при первой загрузке тоже рендерится на сервере в HTML. Разница в том, что его код дополнительно отправляется в браузер и там «оживает» (гидратация).
Рекомендация: воспринимайте директиву как границу, а не как способ убрать ошибку. Все импорты ниже этой границы попадают в клиентский бандл.
Когда «use client» обязателен?
Есть три чётких случая:
- Хуки: useState, useEffect, useRef, useContext и собственные хуки на их основе.
- События: обработчики onClick, onChange, onSubmit, которые реагируют на действия пользователя.
- Возможности браузера: window, document, localStorage и другие API, доступные только в браузере.
Рекомендация: если в компоненте нет ни одного из трёх пунктов, директиву не пишите. Получение данных, вывод текста и списков, структура страницы — всё это выполняется на сервере.
Почему нельзя ставить его везде?
Если добавить «use client» в каждый компонент, ошибка исчезнет, но страница станет тяжелее. Браузеру приходится загружать, разбирать и выполнять больше JavaScript. Сильнее всего это заметно на слабых телефонах и при медленном интернете.
Вторая потеря — преимущества серверных компонентов. На сервере можно напрямую обращаться к базе данных или внутреннему API, а секретные ключи не попадают в браузер. В клиентском компоненте так сделать нельзя.
Рекомендация: при ошибке не добавляйте директиву сразу. Сначала выясните, какой компонент её вызывает, и вынесите только эту часть.
Где проводить границу?
Опускайте границу как можно ниже по дереву компонентов. Если на странице товара интерактивна только кнопка «В корзину», вынесите её в отдельный файл и поставьте директиву только там. Заголовок, описание и изображения останутся на сервере.
Ещё один момент: писать директиву в каждом файле не нужно. Всё, что импортирует клиентский компонент, автоматически переходит на клиентскую сторону.
Рекомендация: оставляйте файлы страниц (page) и макетов (layout) серверными компонентами, а интерактивные части делите на небольшие отдельные компоненты.
Можно ли использовать серверный компонент внутри клиентского?
Можно, но не через импорт. Компонент, импортированный в клиентский файл, сам становится клиентским. Вместо этого передавайте серверный компонент через children или другой проп: например, раскрывающаяся панель будет клиентским компонентом, а её содержимое отрендерится на сервере.
Пропсы, которые передаются с сервера на клиент, должны быть сериализуемыми: строки, числа, массивы, простые объекты. Обычную функцию так передать нельзя.
Рекомендация: используйте приём с children для «обёрток» — провайдеров контекста и модальных окон. Подробности есть в официальной документации Next.js.
Как найти лишние «use client»?
Найдите в проекте строку «use client» и задайте по каждому файлу три вопроса: есть ли хук, есть ли обработчик события, есть ли браузерный API? Если все три ответа «нет», уберите директиву и пересоберите проект.
Рекомендация: начинайте проверку с файлов страниц и макетов. Одна лишняя директива там переводит на клиент всё дерево.
Краткие выводы
- В Next.js App Router компоненты по умолчанию работают на сервере.
- «use client» нужен только для хуков, обработчиков событий и браузерных API.
- Файл с директивой и все его импорты загружаются в браузер как JavaScript.
- Проводите границу на небольшом интерактивном компоненте, а не на всей странице.
- Серверный контент передавайте в клиентский компонент через children.
Часто задаваемые вопросы
Компонент с «use client» совсем не выполняется на сервере?
Выполняется: при первой загрузке он рендерится на сервере в HTML. Затем его код загружается в браузер, и компонент становится интерактивным.
Нужно ли писать «use client» в каждом клиентском файле?
Нет. Директива ставится только в файле-границе, а импортированные им файлы переходят на клиент автоматически.
Можно ли использовать серверный компонент внутри клиентского?
Да, если передать его через children или другой проп. При прямом импорте он тоже станет клиентским.