O que é uma ação do servidor
Parte da seção Essenciais do Next.js do Journey de React da Coddy. Lição 29 de 47.
Agora você pode ler dados no servidor. Hora da outra metade: alterá-los.
Até recentemente, salvar uma linha de texto exigia uma quantidade surpreendente de cerimônia. Você escrevia um endpoint:
// app/api/items/route.js
export async function POST(request) {
const body = await request.json();
saveItem(body.text);
return Response.json({ ok: true });
}… então fez a chamada pelo navegador:
await fetch('/api/items', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ text }),
});Dois arquivos, uma URL, um método, cabeçalhos e JSON nos dois sentidos, para mover uma cadeia de caracteres de um formulário para um banco de dados.
Uma Server Action apaga tudo isso. Escreva uma função assíncrona em um arquivo cuja primeira linha seja 'use server':
// app/actions.js
'use server';
import { saveItem } from '../lib/db';
export async function addItem(formData) {
saveItem(formData.get('text'));
}…e passe essa função para um formulário:
<form action={addItem}>
<input name="text" />
<button type="submit">Add</button>
</form>É só isso. Vale a pena destacar três detalhes:
'use server'precisa ser a primeira linha do arquivo: é o mesmo tipo de marcador que'use client', mas apontando na direção oposta. Ele diz: tudo o que é exportado aqui é executado no servidor.- O corpo da função nunca chega ao navegador. Suas credenciais do banco de dados ficam seguras dentro dela: o navegador recebe apenas uma referência que pode chamar.
- Você não escreveu uma URL. O Next.js cria o endpoint para você;
action={addItem}faz a conexão.
Uma diferença em relação a Fundamentos: esses campos de formulário são não controlados. Sem useState, sem value, sem onChange: o navegador mantém o texto, e o atributo name é como a ação o encontra ao enviar o formulário.
Experimente você mesmo
Esta lição não inclui um desafio de código.
Esta lição inclui um quiz rápido. Comece a lição para respondê-lo e acompanhar seu progresso.
Todas as lições de Essenciais do Next.js
2Rotas e links
Pastas são rotasRotas aninhadasLinks entre páginasRotas dinâmicasPáginas não encontradasRevisão: rotas3Layouts e Metadados
O Layout RaizNavegação CompartilhadaLayouts AninhadosMetadados da PáginaMetadados DinâmicosRevisão: Layouts6Ações do servidor
O que é uma ação do servidorFormulários em açãoLendo dados do formulárioAtualizando a páginaRevisão: ações do servidor