Gestionnaires de routes
Fait partie de la section L'essentiel de Next.js du Journey React de Coddy. Leçon 37 sur 47.
Les composants serveur couvrent la plupart des besoins en données, car ils s’exécutent déjà sur le serveur. Mais parfois, le navigateur doit demander des données plus tard, après un clic, une fois qu’une zone de recherche a fini de se mettre à jour ; pour cela, il te faut un point de terminaison à appeler.
Un dossier contenant un route.js devient exactement cela. Même règle de routage que pour les pages, fichier spécial différent :
app/
api/
dishes/
route.js -> /api/dishesÀ l’intérieur, vous exportez une fonction portant le nom de la méthode HTTP :
import { dishes } from '../../../lib/dishes.js';
export async function GET() {
return Response.json(dishes);
}Response.json(...) constitue toute la réponse : cette méthode sérialise la valeur et définit le type de contenu JSON. Tu peux aussi exporter POST, PUT et DELETE depuis le même fichier.
Ensuite, la partie cliente est du code de navigateur ordinaire :
const res = await fetch('/api/dishes');
const data = await res.json();Deux choses à retenir. Un dossier peut contenir un page.jsx ou un route.js, jamais les deux : ils revendiqueraient la même URL. Et route.js n’est pas un composant : il renvoie une Response, pas du JSX.
Utilise un gestionnaire de route lorsque le navigateur a besoin de données à la demande, ou lorsqu’un élément extérieur à ton application doit faire appel à celle-ci. Si un composant serveur peut simplement lire les données pendant le rendu, laisse-le faire.
Défi
MoyenCrée une petite API et appelle-la depuis le navigateur.
- Dans
app/api/dishes/route.js, exporte uneasync function GETqui renvoiedishesau format JSON. - Dans
components/DishLoader.jsx, termineloadDishes: récupère/api/dishes, lis le corps JSON et stocke les noms des plats avecsetNames.
En cliquant sur #load-btn, la liste #dish-list doit afficher les quatre noms.
Essayez vous-même
import './globals.css';
export const metadata = {
title: 'My App',
};
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>
{children}
</body>
</html>
);
}Cette leçon comprend un petit quiz. Commencez la leçon pour y répondre et suivre votre progression.
Toutes les leçons de L'essentiel de Next.js
1Pourquoi Next.js
Ce que Next.js apporteLe dossier appVotre première pageRécapitulatif : pourquoi Next.js4Serveur et client
Deux types de composantsComprendre l’erreurLa ligne « use client »Garder les parties côté client petitesLe serveur dans le clientRécapitulatif : serveur et client7Navigation côté client
Le lien actifRoutage programmatiqueFiltrer avec l’URLGestionnaires de routesRécapitulatif : navigation2Routage et liens
Les dossiers sont des routesRoutes imbriquéesLier les pagesRoutes dynamiquesPages introuvablesRécapitulatif : routage