Φόρτωση περιεχομένου...
Φόρτωση περιεχομένου...
Χτίστε loading.tsx skeletons, error.tsx ανάκαμψη και notFound() για καθαρές ροές σφαλμάτων.
Στο Next.js 16 App Router, η εμπειρία του χρήστη κατά τη φόρτωση δεδομένων και η ανάκαμψη από απρόβλεπτα σφάλματα δεν υλοποιούνται με χειροκίνητα try/catch στα components, αλλά μέσω της σύμβασης ειδικών αρχείων (Special Segment Files).
Το αρχείο loading.tsx δημιουργεί αυτόματα ένα React Suspense Boundary γύρω από το αντίστοιχο page.tsx. Εμφανίζεται άμεσα κατά τη μετάβαση, προσφέροντας στιγμιαία απόκριση:
// app/courses/[slug]/loading.tsx
import { Skeleton } from "@/components/ui/skeleton"
export default function CourseLoading() {
return (
<div className="container max-w-5xl py-8 space-y-6">
{/* Skeleton Hero Banner */}
<div className="space-y-3">
<Skeleton className="h-8 w-48 rounded-md" />
<Skeleton className="h-12 w-3/4 rounded-lg" />
<Skeleton className="h-4 w-1/2 rounded-md" />
</div>
{/* Skeleton Curriculum Grid */}
<div className="grid gap-4 md:grid-cols-2 mt-8">
{[1, 2, 3, 4].map((i) => (
<div key={i} className="border border-border/50 rounded-xl p-5 space-y-3">
<Skeleton className="h-6 w-32" />
<Skeleton className="h-4 w-full" />
<Skeleton className="h-4 w-5/6" />
</div>
))}
</div>
</div>
)
}Το error.tsx λειτουργεί ως React Error Boundary. Πρέπει υποχρεωτικά να είναι Client Component ("use client"), καθώς παρακολουθεί runtime σφάλματα κατά το render:
// app/courses/[slug]/error.tsx
"use client"
import { useEffect } from "react"
import { Button } from "@/components/ui/button"
import { AlertCircle, RotateCcw } from "lucide-react"
export default function CourseError({
error,
reset,
}: {
error: Error & { digest?: string }
reset: () => void
}) {
useEffect(() => {
// Καταγραφή του σφάλματος σε εξωτερική υπηρεσία (π.χ. Sentry)
console.error("Σφάλμα φόρτωσης μαθήματος:", error)
}, [error])
return (
<div className="min-h-[400px] flex flex-col items-center justify-center text-center p-6 space-y-4">
<div className="h-14 w-14 rounded-full bg-destructive/10 text-destructive flex items-center justify-center">
<AlertCircle className="h-8 w-8" />
</div>
<div className="space-y-1">
<h2 className="text-xl font-bold">Παρουσιάστηκε Σφάλμα</h2>
<p className="text-sm text-muted-foreground max-w-md">
Δεν ήταν δυνατή η ανάκτηση των δεδομένων του μαθήματος.
{error.digest && <span className="block text-xs font-mono mt-1 text-zinc-500">ID: {error.digest}</span>}
</p>
</div>
<Button onClick={() => reset()} variant="outline" className="gap-2">
<RotateCcw className="h-4 w-4" />
Δοκιμάστε Ξανά
</Button>
</div>
)
}Όταν ένα μάθημα ή οδηγός δεν υπάρχει στη βάση, δεν εκτοξεύουμε unhandled 500 error, αλλά καλούμε τη συνάρτηση notFound(), η οποία αποδίδει το πλησιέστερο not-found.tsx:
// app/courses/[slug]/page.tsx
import { notFound } from 'next/navigation'
import { getCourseBySlug } from '@/lib/data/school-service'
export default async function CoursePage({
params,
}: {
params: Promise<{ slug: string }>
}) {
const { slug } = await params
const course = await getCourseBySlug(slug)
if (!course) {
notFound() // Μεταφέρει άμεσα τον έλεγχο στο not-found.tsx
}
return <main>{course.title}</main>
}| Αρχείο | Runtime Περιβάλλον | Ρόλος & Σκοπός |
|---|---|---|
loading.tsx | Server Component | Αυτόματο Suspense skeleton UI κατά το streaming |
error.tsx | Client Component ("use client") | Error Boundary με συνάρτηση ανάκαμψης reset() |
not-found.tsx | Server Component | Εξειδικευμένο 404 UI όταν καλείται το notFound() |
global-error.tsx | Client Component | Τελευταίο fallback για σφάλματα εντός του root layout.tsx |
loading.tsx φτιάχνει αυτόματο Suspense Boundary με skeletons και φαίνεται άμεσα κατά το streaming.error.tsx είναι υποχρεωτικά Client Component με "use client", παίρνει error και reset() και ξαναπροσπαθεί με το κουμπί.notFound() αποδίδει το πλησιέστερο not-found.tsx όταν το slug δεν υπάρχει, αντί για 500.loading.tsx και not-found.tsx είναι Server Components, ενώ error.tsx και global-error.tsx είναι Client Components.