Директива use server
На этой странице
"use server" объявляет серверные функции, которые React и Next.js могут вызывать через границу между клиентом и сервером.
Вопрос
Где писать "use server" и нужна ли она каждому Server Component?
Основная идея
Директива — строка в начале файла или тела асинхронной функции. Это специальная инструкция сборщику, а не обычный вызов JavaScript.
Если поставить ее в начале отдельного модуля, его экспортируемые функции становятся серверными и должны быть асинхронными. Такой модуль можно импортировать из Client Component: браузер получит ссылку для вызова, а не реализацию с серверными зависимостями.
Директиву внутри функции можно использовать в Server Component, чтобы объявить Action рядом с формой. Создать такую встроенную Action внутри Client Component нельзя: для клиентского импорта используют отдельный модуль с директивой на уровне файла.
Обычным Server Components директива не нужна. В App Router страницы уже являются серверными по умолчанию.
Самая частая путаница: use server vs use client
"use client" | "use server" | |
|---|---|---|
| Что помечает | Границу: модуль и его импорты — клиентский код | Функции, которые можно вызвать с клиента, но выполняются на сервере |
| Где ставят | В начале файла компонента | В начале файла с Actions или в теле async-функции |
| Нужна ли Server Component | — | Нет: компоненты серверные по умолчанию |
| Что получает браузер | JS-код модуля | Только ссылку (id) на функцию |
| Пример | "use client"; export function Counter() | "use server"; export async function save() |
Ошибка новичка: поставить "use server" в начало page.tsx, «чтобы компонент был серверным».
→ Next.js будет считать ВСЕ экспорты файла Server Actions и потребует, чтобы они были async-функциями.
Правильно: page.tsx без директив — он уже серверный.Как это работает под капотом
Сборка: saveFont получает id "7f3a…"
Браузер: <form action={saveFont}> → в HTML/JS лежит только id
Отправка: POST текущего URL, заголовок Next-Action: 7f3a…, тело — FormData
Сервер: Next.js находит функцию по id → выполняет → возвращает результат + обновлённый RSCПоэтому любую экспортированную Action можно вызвать «вручную» с произвольными аргументами — проверки доступа и валидация обязательны внутри (см. урок о безопасности Server Actions).
Пример: отдельный модуль с Action
Самодостаточный пример для Next.js 16 App Router. Изменяется только предпочтение текущего браузера.
// app/actions.ts
"use server";
import { cookies } from "next/headers";
export async function saveFont(formData: FormData) {
const size = formData.get("size");
if (size !== "normal" && size !== "large") {
throw new Error("Недопустимый размер");
}
(await cookies()).set("fontSize", size, {
path: "/",
httpOnly: true,
sameSite: "lax",
secure: process.env.NODE_ENV === "production",
});
}// app/page.tsx
import { saveFont } from "./actions";
export default function Page() {
return <form action={saveFont}>
<label htmlFor="size">Размер текста</label>
<select id="size" name="size">
<option value="normal">Обычный</option>
<option value="large">Крупный</option>
</select>
<button type="submit">Сохранить</button>
</form>;
}Action сохранит cookie. Применение размера к CSS — отдельный шаг, не включенный в пример.
Что важно помнить
"use server" не создает систему доступа. Перед реальным изменением профиля, покупки или записи в базе проверяют пользователя, права и параметры внутри серверной функции.
Не экспортируй из Action-модуля обычные значения конфигурации: перенеси их в другой файл. Аргументы и результаты вызова должны поддерживать сериализацию React.
Мини-шпаргалка
- В начале файла: серверные экспорты.
- Внутри async-функции Server Component: отдельная Action.
- Для обычного Server Component директива не требуется.