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()
不需要你使用return notFound()
,因为它使用了 TypeScript 的never
类型。
版本历史
版本 | 变更 |
---|---|
v13.0.0 | notFound 引入。 |