Menu
CoddyTech

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/dishes

Dentro 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.

challenge icon

Desafio

Médio

Crie uma pequena API e chame-a pelo navegador.

  1. Em app/api/dishes/route.js, exporte uma async function GET que retorne dishes como JSON.
  2. Em components/DishLoader.jsx, conclua loadDishes: busque /api/dishes, leia o corpo JSON e armazene os nomes dos pratos com setNames.

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>
    );
}
quiz iconTeste seus conhecimentos

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