notFound

notFound 関数を使用すると、ルートセグメント内で not-found ファイル をレンダリングし、<meta name="robots" content="noindex" /> タグを注入できます。

notFound()

notFound() 関数を呼び出すと NEXT_HTTP_ERROR_FALLBACK;404 エラーがスローされ、スローされたルートセグメントのレンダリングが終了します。not-found ファイルを指定することで、セグメント内で Not Found UI をレンダリングしてこのようなエラーを適切に処理できます。

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

  // ...
}

補足: notFound() は TypeScript の never 型を使用しているため、return notFound() を使用する必要はありません。

バージョン履歴

バージョン変更内容
v13.0.0notFound が導入されました。

On this page