Manipuladores de rota
Parte da seção Essenciais do Next.js do Journey de React da Coddy. Lição 37 de 47.
Os componentes de servidor atendem à maioria das necessidades de dados, porque já são executados no servidor. Mas, às vezes, o navegador precisa solicitar dados mais tarde, depois de um clique, depois que uma caixa de pesquisa para de mudar, e, para isso, você precisa de um endpoint para chamar.
Uma pasta que contém um route.js se torna exatamente isso. A mesma regra de roteamento das páginas, mas com um arquivo especial diferente:
app/
api/
dishes/
route.js -> /api/dishesDentro dela, você exporta uma função com o nome do método HTTP:
import { dishes } from '../../../lib/dishes.js';
export async function GET() {
return Response.json(dishes);
}Response.json(...) é a resposta inteira: ele serializa o valor e define o tipo de conteúdo JSON. Você também pode exportar POST, PUT e DELETE do mesmo arquivo.
Então, a parte do cliente é um código comum de navegador:
const res = await fetch('/api/dishes');
const data = await res.json();Duas coisas para ter em mente. Uma pasta pode conter um page.jsx ou um route.js, nunca os dois: ambos reivindicariam a mesma URL. E route.js não é um componente: ele retorna uma Response, não JSX.
Use um manipulador de rota quando o navegador precisar de dados sob demanda ou quando algo fora do seu app precisar fazer uma chamada. Se um componente de servidor puder simplesmente ler os dados durante a renderização, deixe que ele faça isso.
Desafio
MédioCrie uma pequena API e chame-a pelo navegador.
- Em
app/api/dishes/route.js, exporte umaasync function GETque retornedishescomo JSON. - Em
components/DishLoader.jsx, conclualoadDishes: busque/api/dishes, leia o corpo JSON e armazene os nomes dos pratos comsetNames.
Ao clicar em #load-btn, #dish-list deve ser preenchida com os quatro nomes.
Experimente você mesmo
import './globals.css';
export const metadata = {
title: 'My App',
};
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>
{children}
</body>
</html>
);
}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
4Servidor e Cliente
Dois tipos de componenteLendo o erroA linha "use client"Mantenha pequenas as partes do clienteServidor dentro do clienteRecapitulando: Servidor e Cliente7Navegação no cliente
O link ativoRoteamento programáticoFiltragem com a URLManipuladores de rotaRevisão: navegação