generateMetadataにあるparentを扱いやすくするヘルパー関数

getParentMetadataProperty.ts

/**
 * 親セグメントから特定のメタデータを取得する
 * 指定されたプロパティの存在するフィールドのみをフィルタリングして取得する
 * @param parentMetadata 親セグメントから取得するメタデータ
 * @param propertyName 取得したいプロパティ名（'openGraph', 'alternates'など）
 * @example
 * import type { Metadata, ResolvingMetadata } from 'next';
 * import { getParentMetadataProperty } from '@/lib/metadata/helpers';
 *
 * export async function generateMetadata(
 *   { params }: { params: Promise<{ lang: string; id: string }> },
 *   parent: ResolvingMetadata,
 * ): Promise<Metadata> {
 *   const { lang, id } = await params;
 *   const pageUrl = buildAbsoluteUrl([lang, 'article', id]);
 *
 *   return {
 *     openGraph: {
 *       // ogp画像やlocaleなどをコピーして上書きする
 *       ...await getParentMetadataProperty(parent, 'openGraph'),
 *       type: 'website', // 親のtypeを上書き
 *       url: pageUrl, // ページ固有のURLを追加
 *     },
 *     alternates: {
 *       // languagesでhreflangを指定しているのでコピーする
 *       ...await getParentMetadataProperty(parent, 'alternates'),
 *       canonical: pageUrl, // canonicalを追加/上書き
 *     },
 *   };
 * }
 */
export async function getParentMetadataProperty<K extends keyof Metadata>(
  parentMetadata: ResolvingMetadata,
  propertyName: K,
): Promise<Partial<NonNullable<Metadata[K]>>> {
  const resolved = await parentMetadata;
  const parentProperty = resolved[propertyName];

  if (!parentProperty || typeof parentProperty !== 'object') {
    return {};
  }

  // 存在するフィールドを動的にフィルタリングして取得
  const result: Record<string, unknown> = {};
  for (const [key, value] of Object.entries(parentProperty)) {
    // 値が存在する場合のみ取得
    if (value !== undefined && value !== null) {
      result[key] = value;
    }
  }

  return result as Partial<NonNullable<Metadata[K]>>;
}