Menu
CoddyTech

Обработчики маршрутов

Часть раздела Основы Next.js путешествия по React на Coddy. Урок 37 из 47.

Серверные компоненты покрывают большинство потребностей в данных, потому что они уже выполняются на сервере. Но иногда браузеру нужно запросить данные позже — после нажатия, после того как поиск в поле поиска завершится, и для этого нужна конечная точка, к которой можно обратиться.

Папка с файлом route.js становится именно таким маршрутом. То же правило маршрутизации, что и для страниц, но специальный файл другой:

app/
    api/
        dishes/
            route.js     ->  /api/dishes

Внутри вы экспортируете функцию, названную в честь метода HTTP:

import { dishes } from '../../../lib/dishes.js';

export async function GET() {
    return Response.json(dishes);
}

Response.json(...) — это весь ответ: он сериализует значение и устанавливает тип содержимого JSON. Из этого же файла можно экспортировать и POST, PUT, DELETE.

Затем клиентская часть представляет собой обычный код для браузера:

const res = await fetch('/api/dishes');
const data = await res.json();

Важно помнить о двух вещах. В папке может находиться page.jsx или route.js, но не оба файла сразу: оба претендовали бы на один и тот же URL. А route.js — это не компонент: он возвращает Response, а не JSX.

Используй обработчик маршрута, когда браузеру нужны данные по запросу или когда что-то за пределами твоего приложения должно обратиться к нему. Если серверный компонент может просто прочитать данные во время рендеринга, пусть так и делает.

challenge icon

Задание

Средне

Создай небольшой API и вызови его из браузера.

  1. В app/api/dishes/route.js экспортируй async function GET, которая возвращает dishes в формате JSON.
  2. В components/DishLoader.jsx допиши loadDishes: получи данные с помощью fetch по адресу /api/dishes, прочитай тело ответа в формате JSON и сохрани названия блюд с помощью setNames.

При нажатии на #load-btn в #dish-list должны появиться все четыре названия.

Попробуйте сами

import './globals.css';

export const metadata = {
    title: 'My App',
};

export default function RootLayout({ children }) {
    return (
        <html lang="en">
            <body>
                {children}
            </body>
        </html>
    );
}
quiz iconПроверьте себя

В этом уроке есть небольшой тест. Начните урок, чтобы ответить на вопросы и сохранить прогресс.

Все уроки раздела Основы Next.js