コンテンツをスキップ

メタデータファイルAPIリファレンス

このドキュメントセクションでは**メタデータファイルの命名規則**について説明します。ファイルベースのメタデータは、特別なメタデータファイルをルートセグメントに追加することで定義できます。

各ファイル命名規則は、静的ファイル (例: opengraph-image.jpg) または、コードを使用してファイルを生成する動的バリアント (例: opengraph-image.js) を使用して定義できます。

ファイルが定義されると、Next.jsは自動的にファイルを配信し (本番環境ではキャッシュのためにハッシュが付加されます)、アセットのURL、ファイルタイプ、画像サイズなど、関連するhead要素を正しいメタデータで更新します。

知っておくと良いこと:

  • sitemap.tsopengraph-image.tsxicon.tsxなどの特別なルーティングハンドラーやその他のメタデータファイルは、デフォルトでキャッシュされます。
  • middleware.tsと併用する場合は、matcherを設定してメタデータファイルを除外してください。