Typy App Routera; komponenty serwerowe a klienckie
Poznanie ustawień domyślnych App Routera (komponenty serwerowe), sytuacji wymagających użycia komponentów klienckich oraz typowania handlerów tras
Typy App Routera; komponenty serwerowe a klienckie to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 1 z 3. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej TypeScript Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs TypeScript Academy zawiera 3 lekcji w sumie.
Wprowadzenie
Cel: Swobodnie korzystać z App Routera i TypeScriptu. Domyślnie używane są komponenty serwerowe, w razie potrzeby można włączyć komponenty klienckie, a także typować handlery tras dla endpointów API.
- Możliwości serwera i klienta
- Przekazywanie między nimi typowanych właściwości
- Typowanie NextRequest/NextResponse
Komponent serwerowy
Pliki w katalogu app/ są domyślnie komponentami serwerowymi. Można w nich wykonywać kod przeznaczony wyłącznie dla serwera i pobierać dane przed renderowaniem.
// app/page.tsx (server component by default)
export default async function Page() {
// Server code: read env, fetch data, call DB (conceptually)
const data: { message: string } = { message: "Hello from server component" }
return (
<main style={{ display: "grid", gap: 8 }}>
<h1>Home</h1>
<p>{data.message}</p>
</main>
)
}Komponent kliencki
Aby włączyć hooki i handlery zdarzeń, należy na początku dodać dyrektywę "use client". Komponenty klienckie działają w przeglądarce.
"use client"
import { useState } from "react"
// app/components/Counter.tsx (client component)
export default function Counter() {
const [n, setN] = useState(0)
return (
<div style={{ display: "flex", gap: 8, alignItems: "center" }}>
<button onClick={() => setN(n - 1)}>-</button>
<span>{n}</span>
<button onClick={() => setN(n + 1)}>+</button>
</div>
)
}Właściwości z serwera do klienta
Dane należy obliczać na serwerze i przekazywać je jako typowane właściwości do komponentów klienckich. Logikę przeznaczoną wyłącznie dla serwera należy trzymać poza klientem.
// app/page.tsx (server) + client import
import Counter from "./components/Counter"
export default async function Page() {
const initial = 5 // fetched or computed on the server
return (
<main style={{ display: "grid", gap: 12 }}>
<h2>Dashboard</h2>
<CounterWithStart start={initial} />
</main>
)
}
// app/components/CounterWithStart.tsx
"use client"
import { useState } from "react"
export default function CounterWithStart({ start }: { start: number }) {
const [n, setN] = useState(start)
return (
<div style={{ display: "flex", gap: 8, alignItems: "center" }}>
<button onClick={() => setN(n - 1)}>-</button>
<span>{n}</span>
<button onClick={() => setN(n + 1)}>+</button>
</div>
)
}Handlery tras
Należy używać NextRequest/NextResponse do tworzenia typowanych handlerów w plikach app/api/*/route.ts. Odpowiedzi JSON powinny zawierać kody statusu.
// app/api/hello/route.ts (App Router API)
import { NextRequest, NextResponse } from "next/server"
export async function GET(req: NextRequest) {
const name = req.nextUrl.searchParams.get("name") ?? "world"
const body: { message: string } = { message: `Hello, ${name}!` }
return NextResponse.json(body, { status: 200 })
}
export async function POST(req: NextRequest) {
const payload = (await req.json()) as { name?: string }
const body = { created: true, name: payload.name ?? "anon" }
return NextResponse.json(body, { status: 201 })
}Wskazówki
Wskazówki:
- Domyślnie należy wybierać komponenty serwerowe, a komponenty klienckie włączać tylko wtedy, gdy potrzebna jest interaktywność.
- Właściwości przekazywane między serwerem a klientem powinny być niewielkie i możliwe do serializacji.
- Należy konsekwentnie używać typowanych kształtów
NextResponse.json.
Sprawdzenie klienta App Routera
Szybkie sprawdzenie: Jak włączyć hooki w pliku komponentu w ramach App Routera?
Podsumowanie
Podsumowanie: App Router domyślnie korzysta z komponentów serwerowych; aby włączyć interaktywność, należy dodać "use client", przekazywać typowane właściwości przez granicę oraz typować handlery tras za pomocą NextRequest/NextResponse.
Często zadawane pytania
Czy lekcja „Typy App Routera; komponenty serwerowe a klienckie” jest bezpłatna?
Tak — pełny tekst „Typy App Routera; komponenty serwerowe a klienckie” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu TypeScript Academy, przejdź na CoddyKit PRO. Kurs TypeScript Academy zawiera 3 lekcji w sumie.
Co nauczysz się w „Typy App Routera; komponenty serwerowe a klienckie”?
Poznanie ustawień domyślnych App Routera (komponenty serwerowe), sytuacji wymagających użycia komponentów klienckich oraz typowania handlerów tras Ćwiczysz TypeScript Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć TypeScript Academy?
Nie wymagamy żadnego doświadczenia. TypeScript Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 3.
Ile czasu zajmuje lekcja „Typy App Routera; komponenty serwerowe a klienckie”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji TypeScript Academy?
Tak. Każda lekcja TypeScript Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Typy App Routera; komponenty serwerowe a klienckie
- Pobieranie danych i typowanie akcji
- Typowanie zmiennych środowiskowych i konfiguracja