Menu
CoddyTech

Что такое серверное действие

Часть раздела Основы Next.js путешествия по React на Coddy. Урок 29 из 47.

Теперь ты можешь читать данные на сервере. Пора перейти ко второй половине: изменять их.

До недавнего времени сохранение одной строки текста требовало удивительно много формальностей. Вы писали обработчик:

// app/api/items/route.js
export async function POST(request) {
    const body = await request.json();
    saveItem(body.text);
    return Response.json({ ok: true });
}

…затем вызвали его из браузера:

await fetch('/api/items', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ text }),
});

Два файла, URL, метод, заголовки и JSON в обоих направлениях — чтобы передать одну строку из формы в базу данных.

Серверное действие удаляет всё это. Напиши асинхронную функцию в файле, первая строка которого — 'use server':

// app/actions.js
'use server';

import { saveItem } from '../lib/db';

export async function addItem(formData) {
    saveItem(formData.get('text'));
}

…и передай эту функцию форме:

<form action={addItem}>
    <input name="text" />
    <button type="submit">Add</button>
</form>

Вот и всё. Стоит упомянуть три детали:

  • 'use server' должно быть первой строкой файла: это такой же маркер, как 'use client', но указывающий в другую сторону. Он говорит, что всё экспортируемое отсюда выполняется на сервере.
  • Тело функции никогда не попадает в браузер. Данные доступа к базе данных в безопасности внутри неё: браузер получает только ссылку, которую может вызвать.
  • Тебе не пришлось указывать URL. Next.js создаёт конечную точку за тебя; action={addItem} — это связка.

Одно отличие от Fundamentals: эти поля ввода формы неконтролируемые. Без useState, без value, без onChange: браузер хранит текст, а атрибут name позволяет действию найти его при отправке формы.

Попробуйте сами

В этом уроке нет задания по программированию.

quiz iconПроверьте себя

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

Все уроки раздела Основы Next.js