onInvalidateとは

onInvalidateはrouter.prefetch()の第2引数として渡すコールバック関数で、プリフェッチされたデータがNext.jsによって「古い」と判断されたときに呼び出されます。

重要な特性:

プリフェッチリクエストごとに最大1回のみ呼び出される
キャッシュの無効化を検知し、新しいプリフェッチをトリガーするタイミングを知らせる

例

onInvalidateを使用して、キャッシュが無効化されるたびに自動的に再プリフェッチするリンクは以下のように実装できます。

'use client'
import { useRouter } from 'next/navigation'
import { useEffect } from 'react'

function ManualPrefetchLink({
  href,
  children,
}: {
  href: string
  children: React.ReactNode
}) {
  const router = useRouter()

  useEffect(() => {
    let cancelled = false

    const poll = () => {
      if (!cancelled) {
        router.prefetch(href, { onInvalidate: poll })
      }
    }

    poll() // 初回プリフェッチを実行

    return () => {
      cancelled = true // クリーンアップ
    }
  }, [href, router])

  return (
    <a
      href={href}
      onClick={(event) => {
        event.preventDefault()
        router.push(href)
      }}
    >
      {children}
    </a>
  )
}

参考