forbidden.js
experimental
forbidden.js 特殊文件的 API 参考。
当调用 forbidden 函数时,forbidden 文件会渲染 UI。
在流式传输开始之前,Next.js 会返回 403 状态码。流式传输开始后,状态码保持为 200,并在响应中渲染 forbidden UI。在这两种情况下,Next.js 都会注入一个 <meta name="robots" content="noindex" /> 标签。详情请参阅状态码。
app/forbidden.tsx
import Link from 'next/link'
export default function Forbidden() {
return (
<div>
<h2>Forbidden</h2>
<p>You are not authorized to access this resource.</p>
<Link href="/">Return Home</Link>
</div>
)
}app/forbidden.jsx
import Link from 'next/link'
export default function Forbidden() {
return (
<div>
<h2>Forbidden</h2>
<p>You are not authorized to access this resource.</p>
<Link href="/">Return Home</Link>
</div>
)
}参考#
Props#
forbidden.js 组件不接受任何 props。
小知识:Next.js 会将每个
forbidden.js文件与其所在段下的每个路由一起发送,即使从未调用forbidden(),也会在这些页面上加载它导入的 Client Components。在那里应优先使用 Server Components 和<Link>,而不是交互式 UI。
版本历史#
| 版本 | 变更 |
|---|---|
v15.1.0 | 引入 forbidden.js。 |