Mazmunga ötiş
saidqodirxon.uz
← Barça yozuvlar

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 или другой проп. При прямом импорте он тоже станет клиентским.

Что делать, если после удаления директивы появилась ошибка?

Текст ошибки обычно указывает, какой хук или обработчик вызывает проблему. Вынесите эту часть в отдельный небольшой компонент и поставьте директиву только там.


Telegram | LinkedIn | Instagram | Website

Смотреть в Instagram ↗Смотреть в Telegram ↗