Что такое серверное действие
Часть раздела Основы 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 позволяет действию найти его при отправке формы.
Попробуйте сами
В этом уроке нет задания по программированию.
В этом уроке есть небольшой тест. Начните урок, чтобы ответить на вопросы и сохранить прогресс.
Все уроки раздела Основы Next.js
2Маршрутизация и ссылки
Папки — это маршрутыВложенные маршрутыСвязывание страницДинамические маршрутыСтраницы 404Повторение: маршрутизация3Макеты и метаданные
Корневой макетОбщая навигацияВложенные макетыМетаданные страницыДинамические метаданныеПовторение: макеты6Серверные действия
Что такое серверное действиеФормы, которые действуютЧтение данных формыОбновление страницыПовторение: серверные действия