コンテンツにスキップ

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

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

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

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

知っておくと良いこと:

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