re:re:actable
Урок 053 минуты чтения

Ограничения серверных компонентов

На этой странице
Кратко

Серверный компонент выполняется вне браузера. Он подготавливает интерфейс, но не хранит клиентское состояние и не обслуживает браузерные события.

Вопрос

Почему в серверном компоненте нельзя использовать useState или onClick и как правильно добавить интерактивность?

Основная идея

Клик происходит в браузере, а код серверного компонента там не выполняется. Поэтому он не может напрямую подписаться на onClick, читать window или обновлять локальный state через useState.

Эффекты useEffect и DOM-ссылки также относятся к клиентской стороне. Серверные компоненты не читают клиентский React Context: для провайдера и потребителей контекста создают клиентскую границу.

Ограничения не запрещают строить общий интерфейс. Серверный родитель может соединить серверное содержимое и клиентскую обертку через props, в том числе children.

Пример: серверный текст в клиентской обертке

// app/expandable.tsx
"use client";
 
import { useState, type ReactNode } from "react";
 
export default function Expandable({ children }: { children: ReactNode }) {
  const [open, setOpen] = useState(false);
 
  return (
    <section>
      <button aria-expanded={open} onClick={() => setOpen(value => !value)}>
        {open ? "Скрыть описание" : "Показать описание"}
      </button>
      {open && children}
    </section>
  );
}
// app/page.tsx
import Expandable from "./expandable";
 
function Description() {
  return <p>Эта книга объясняет основы React на примерах.</p>;
}
 
export default function Page() {
  return <Expandable><Description /></Expandable>;
}

Page создает серверное содержимое Description и передает результат в слот children. Expandable переключает его видимость в браузере. Серверный компонент при этом не становится клиентским.

Что можно передать из Server в Client Component через props

ЗначениеМожно?Комментарий
Строки, числа, boolean, null, undefined✓
Простые объекты и массивы из них✓Только нужные поля — всё уходит в браузер
Date, Map, Set, BigInt, typed arrays✓Поддерживаются протоколом RSC
Промис✓Клиент читает через use()
JSX (в том числе серверные компоненты)✓Через children или слоты
Server Action ("use server")✓Передаётся ссылка на серверную функцию
Обычная функция, обработчик✗Ошибка: функции не сериализуются
Экземпляр класса, объект с методами✗Преобразовать в простой объект
Секреты, хэши паролей, приватные поля⚠ Технически можно — нельзяУтечка: props видны в браузере

Типичные ошибки и сообщения

// ✗ «Functions cannot be passed directly to Client Components»
<ClientButton onClick={() => console.log("клик")} />   // в Server Component
 
// ✓ Обработчик объявляется внутри клиентского компонента или передаётся Server Action
<ClientButton productId={id} />
 
// ✗ «useState only works in Client Components»
export default function Page() { const [x, setX] = useState(0); … }  // без "use client"
 
// ✗ Импорт серверного модуля в клиентский компонент
"use client";
import { db } from "@/lib/db"; // секреты и драйвер БД попадут в бандл → защищайтесь import "server-only"

Что важно помнить

Нельзя сохранить серверный модуль серверным, импортировав его в файл с "use client". Такой импорт относится к клиентскому графу; серверные зависимости вроде доступа к файловой системе туда не подходят. Для запрещенного клиентского импорта серверный модуль можно пометить import "server-only".

Обычную серверную функцию с замыканием нельзя передать как onClick. Для обращения к серверу используют предусмотренные интерфейсы, например Server Functions, а не переносят обработчик в серверный компонент.

Серверное содержимое примера подготавливается заранее: open управляет показом, а не откладывает серверную загрузку до клика.

Мини-шпаргалка

  • useState, эффекты, DOM и события - клиентская сторона.
  • children позволяет вложить серверное содержимое в клиентскую обертку.
  • Граф импортов определяет границы выполнения.

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам