notFound

Die notFound-Funktion ermöglicht es Ihnen, die not-found-Datei innerhalb eines Routen-Segments zu rendern sowie ein <meta name="robots" content="noindex" />-Tag einzufügen.

notFound()

Der Aufruf der notFound()-Funktion wirft einen NEXT_HTTP_ERROR_FALLBACK;404-Fehler und beendet das Rendering des Routen-Segments, in dem es geworfen wurde. Durch die Angabe einer not-found-Datei können Sie solche Fehler elegant behandeln, indem Sie eine Not Found-UI innerhalb des Segments rendern.

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()
  }

  // ...
}

Gut zu wissen: notFound() erfordert nicht die Verwendung von return notFound(), da der TypeScript-Typ never verwendet wird.

Versionsverlauf

VersionÄnderungen
v13.0.0notFound eingeführt.

On this page