unauthorized.js

unauthorized ファイルは、認証中に unauthorized 関数が呼び出されたときにUIをレンダリングするために使用されます。UIをカスタマイズできるだけでなく、Next.jsは401ステータスコードを返します。

TypeScript

app/unauthorized.tsx

import Login from '@/app/components/Login'

export default function Unauthorized() {
  return (
    <main>
      <h1>401 - Unauthorized</h1>
      <p>Please log in to access this page.</p>
      <Login />
    </main>
  )
}

JavaScript

app/unauthorized.js

import Login from '@/app/components/Login'

export default function Unauthorized() {
  return (
    <main>
      <h1>401 - Unauthorized</h1>
      <p>Please log in to access this page.</p>
      <Login />
    </main>
  )
}

リファレンス

Props

unauthorized.js コンポーネントは、いかなるpropsも受け付けません。

例

認証されていないユーザーにログインUIを表示する

unauthorized 関数を使用して、ログインUIを持つ unauthorized.js ファイルをレンダリングできます。

TypeScript

app/dashboard/page.tsx

import { verifySession } from '@/app/lib/dal'
import { unauthorized } from 'next/server'

export default async function DashboardPage() {
  const session = await verifySession()

  if (!session) {
    unauthorized()
  }

  return <div>Dashboard</div>
}

JavaScript

app/dashboard/page.js

import { verifySession } from '@/app/lib/dal'
import { unauthorized } from 'next/navigation'

export default async function DashboardPage() {
  const session = await verifySession()

  if (!session) {
    unauthorized()
  }

  return <div>Dashboard</div>
}

TypeScript

app/unauthorized.tsx

import Login from '@/app/components/Login'

export default function UnauthorizedPage() {
  return (
    <main>
      <h1>401 - Unauthorized</h1>
      <p>Please log in to access this page.</p>
      <Login />
    </main>
  )
}

JavaScript

app/unauthorized.js

import Login from '@/app/components/Login'

export default function UnauthorizedPage() {
  return (
    <main>
      <h1>401 - Unauthorized</h1>
      <p>Please log in to access this page.</p>
      <Login />
    </main>
  )
}

バージョン履歴

バージョン	変更点
v15.1.0	unauthorized.js が導入されました