Controladores de rutas
Parte de la sección Esenciales de Next.js del Journey de React de Coddy. Lección 37 de 47.
Los componentes del servidor cubren la mayoría de las necesidades de datos porque ya se ejecutan en el servidor. Pero a veces el navegador tiene que solicitar datos más adelante, después de un clic, cuando se deja de escribir en un cuadro de búsqueda; para eso necesitas un endpoint al que llamar.
Una carpeta que contiene un route.js se convierte exactamente en eso. La misma regla de enrutamiento que para las páginas, pero con un archivo especial diferente:
app/
api/
dishes/
route.js -> /api/dishesDentro, exportas una función cuyo nombre corresponde al método HTTP:
import { dishes } from '../../../lib/dishes.js';
export async function GET() {
return Response.json(dishes);
}Response.json(...) es la respuesta completa: serializa el valor y establece el tipo de contenido JSON. También puedes exportar POST, PUT y DELETE desde el mismo archivo.
Después, la parte del cliente es código normal del navegador:
const res = await fetch('/api/dishes');
const data = await res.json();Hay dos cosas que debes tener claras. Una carpeta puede contener un page.jsx o un route.js, nunca ambos: los dos reclamarían la misma URL. Y route.js no es un componente: devuelve una Response, no JSX.
Recurre a un controlador de rutas cuando el navegador necesite datos bajo demanda o cuando algo externo a tu aplicación necesite comunicarse con ella. Si un componente del servidor puede simplemente leer los datos durante el renderizado, déjalo hacerlo.
Desafío
IntermedioCrea una pequeña API y llámala desde el navegador.
- En
app/api/dishes/route.js, exporta unaasync function GETque devuelvadishescomo JSON. - En
components/DishLoader.jsx, terminaloadDishes: obtiene/api/dishes, lee el cuerpo JSON y guarda los nombres de los platos consetNames.
Al hacer clic en #load-btn, se deben completar #dish-list con los cuatro nombres.
Pruébalo tú mismo
import './globals.css';
export const metadata = {
title: 'My App',
};
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>
{children}
</body>
</html>
);
}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
4Servidor y cliente
Dos tipos de componentesLeer el errorLa línea 'use client'Mantén pequeñas las partes del clienteServidor dentro del clienteRepaso: servidor y cliente7Navegación del cliente
El enlace activoEnrutamiento programáticoFiltrar con la URLControladores de rutasRepaso: navegación