Qué es una acción del servidor
Parte de la sección Esenciales de Next.js del Journey de React de Coddy. Lección 29 de 47.
Ahora puedes leer datos en el servidor. Es hora de la otra mitad: cambiarlos.
Hasta hace poco, guardar una línea de texto requería una cantidad sorprendente de formalidades. Escribías un endpoint:
// app/api/items/route.js
export async function POST(request) {
const body = await request.json();
saveItem(body.text);
return Response.json({ ok: true });
}…después lo llamamos desde el navegador:
await fetch('/api/items', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ text }),
});Dos archivos, una URL, un método, encabezados y JSON en ambas direcciones para mover una cadena de un formulario a una base de datos.
Una acción de servidor lo elimina todo. Escribe una función asíncrona en un archivo cuya primera línea sea 'use server':
// app/actions.js
'use server';
import { saveItem } from '../lib/db';
export async function addItem(formData) {
saveItem(formData.get('text'));
}…y pasa esa función a un formulario:
<form action={addItem}>
<input name="text" />
<button type="submit">Add</button>
</form>Eso es todo. Vale la pena mencionar tres detalles:
'use server'debe ser la primera línea del archivo: el mismo tipo de marcador que'use client', pero en la dirección opuesta. Indica que todo lo que se exporta aquí se ejecuta en el servidor.- El cuerpo de la función nunca llega al navegador. Las credenciales de tu base de datos están seguras dentro de él: el navegador solo recibe una referencia que puede llamar.
- Nunca escribiste una URL. Next.js crea el endpoint por ti;
action={addItem}es la conexión.
Una diferencia con Fundamentos: estas entradas de formulario son no controladas. Sin useState, sin value, sin onChange: el navegador conserva el texto y el atributo name es la forma en que la acción lo encuentra al enviar el formulario.
Pruébalo tú mismo
Esta lección no incluye un desafío de código.
Esta lección incluye un breve cuestionario. Empieza la lección para responderlo y registrar tu progreso.
Todas las lecciones de Esenciales de Next.js
2Rutas y enlaces
Las carpetas son rutasRutas anidadasEnlazar páginasRutas dinámicasPáginas no encontradasRepaso: rutas3Diseños y metadatos
El diseño raízNavegación compartidaDiseños anidadosMetadatos de páginaMetadatos dinámicosRepaso: diseños6Acciones del servidor
Qué es una acción del servidorFormularios que actúanLectura de datos del formularioActualizar la páginaRepaso: acciones del servidor