メタデータファイル API リファレンス
このドキュメントのセクションでは、メタデータファイル規約について説明します。ファイルベースのメタデータは、ルートセグメントに特別なメタデータファイルを追加することで定義できます。
各ファイル規約は、静的ファイル(例: opengraph-image.jpg
)またはコードを使用してファイルを生成する動的バリアント(例: opengraph-image.js
)を使用して定義できます。
ファイルが定義されると、Next.js は自動的にファイルを提供し(本番環境ではキャッシュ用にハッシュ付きで)、アセットの URL、ファイルタイプ、画像サイズなどの適切なメタデータで関連する head 要素を更新します。
知っておくと便利:
sitemap.ts
、opengraph-image.tsx
、icon.tsx
などの特別なルートハンドラーやその他のメタデータファイルは、デフォルトでキャッシュされます。middleware.ts
と併用する場合は、matcher を設定してメタデータファイルを除外してください。