notFound

تتيح لك وظيفة notFound عرض ملف not-found داخل مقطع مسار بالإضافة إلى حقن وسم <meta name="robots" content="noindex" />.

notFound()

استدعاء الدالة notFound() يرمي خطأ NEXT_HTTP_ERROR_FALLBACK;404 ويوقف عرض مقطع المسار الذي تم رمي الخطأ فيه. يتيح لك تحديد ملف not-found معالجة مثل هذه الأخطاء بطريقة أنيقة عن طريق عرض واجهة "غير موجود" داخل المقطع.

app/user/[id]/page.js
import { notFound } from 'next/navigation'

async function fetchUser(id) {
  const res = await fetch('https://...')
  if (!res.ok) return undefined
  return res.json()
}

export default async function Profile({ params }) {
  const { id } = await params
  const user = await fetchUser(id)

  if (!user) {
    notFound()
  }

  // ...
}

معلومة مفيدة: لا تحتاج إلى استخدام return notFound() مع الدالة notFound() بسبب استخدام نوع never في TypeScript.

سجل الإصدارات

الإصدارالتغييرات
v13.0.0تم إدخال notFound.