문서
App Router 사용하기
notFound

notFound

notFound 함수를 사용하면 라우트 세그먼트 내에서 not-found 파일을 렌더링하고 <meta name="robots" content="noindex" /> 태그를 주입할 수 있습니다.

notFound()

notFound() 함수를 호출하면 NEXT_NOT_FOUND 오류가 발생하고 해당 함수가 호출된 라우트 세그먼트의 렌더링이 종료됩니다. 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 user = await fetchUser(params.id);
 
  if (!user) {
    notFound();
  }
 
  // ...
}

알아두면 좋은 점: notFound()는 TypeScript never 타입을 사용하기 때문에 return notFound()를 사용할 필요가 없습니다.

버전 기록

버전변경 사항
v13.0.0notFound가 도입되었습니다.