NNext.js 中文网 GitHub

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。
Next.js 中文网