unstable_rethrow

unstable_rethrowは、アプリケーションコードでスローされたエラーを処理しようとする際に、Next.jsによって内部的にスローされるエラーを回避するために使用できます。

例えば、notFound関数を呼び出すと、Next.js内部のエラーがスローされ、not-found.jsコンポーネントがレンダリングされます。しかし、try/catchブロック内で使用すると、エラーがキャッチされ、not-found.jsのレンダリングが阻止されます：

@/app/ui/component.tsx

import { notFound } from 'next/navigation'
 
export default async function Page() {
  try {
    const post = await fetch('https://.../posts/1').then((res) => {
      if (res.status === 404) notFound()
      if (!res.ok) throw new Error(res.statusText)
      return res.json()
    })
  } catch (err) {
    console.error(err)
  }
}

unstable_rethrow APIを使用して、内部エラーを再スローし、期待される動作を継続できます：

@/app/ui/component.tsx

import { notFound, unstable_rethrow } from 'next/navigation'
 
export default async function Page() {
  try {
    const post = await fetch('https://.../posts/1').then((res) => {
      if (res.status === 404) notFound()
      if (!res.ok) throw new Error(res.statusText)
      return res.json()
    })
  } catch (err) {
    unstable_rethrow(err)
    console.error(err)
  }
}

以下のNext.jsのAPIは、エラーをスローし、Next.js自体によって処理される必要があります：

ルートセグメントが静的でない限りエラーをスローするように指定されている場合、動的APIの呼び出しもエラーをスローし、開発者によってキャッチされるべきではありません。部分的なプリレンダリング（PPR）もこの動作に影響することに注意してください。これらのAPIは：

cookies
headers
searchParams
fetch(..., { cache: 'no-store' })
fetch(..., { next: { revalidate: 0 } })

補足:

このメソッドは、エラーオブジェクトを唯一の引数として、キャッチブロックの先頭で呼び出される必要があります。また、プロミスの.catchハンドラー内でも使用できます。

APIの呼び出しがtry/catchでラップされていない場合、unstable_rethrowを使用する必要はありません

リソースのクリーンアップ（インターバル、タイマーなどのクリア）は、unstable_rethrowの呼び出しの前、またはfinallyブロック内で行う必要があります。