Next.jsで学ぶReact講座 90日コース | Next.js基礎 - Day 50:Next.js復習

React Next.jsで学ぶReact講座90日コース
スポンサーリンク
スポンサーリンク
  1. Day 50:Next.js復習 ― 複数ページ・API取得・Loading・Error・Metadataを備えたWebサイトを自力で作る
  2. 今回の完成条件を確認する
  3. 最初は参考コードを見ずに設計する
    1. 自力で取り組むための最小仕様
  4. 今回の構成と前提を決める
    1. URLとページの対応
    2. Server ComponentとClient Componentの分担
  5. プロジェクトを準備する
  6. 完成時のファイル構成
  7. 記事データの型を定義する
    1. src/types/post.ts
    2. 型を書くだけでは外部データを検証できない
  8. API取得処理をサービスへまとめる
    1. src/services/post.service.ts
    2. nullと例外の意味を分ける
    3. fetch()の前後で何が起きるか
  9. 共通レイアウトを作る
    1. src/app/layout.tsx
  10. ホームページを作る
    1. src/app/page.tsx
  11. サイト説明ページを作る
    1. src/app/about/page.tsx
  12. 記事カードを作る
    1. src/components/PostCard.tsx
  13. 記事一覧ページでAPIを取得する
    1. src/app/posts/page.tsx
    2. 表示件数と取得件数は違う
  14. Dynamic Routeで記事詳細を作る
    1. src/app/posts/[id]/page.tsx
    2. [id]とparams.idを対応させる
    3. Metadataと本文で取得処理がある理由
  15. Loading UIを追加する
    1. src/app/posts/loading.tsx
    2. ローディングが見えないこともある
    3. Suspenseを追加するなら、待つ場所を内側へ移す
  16. エラー画面を追加する
    1. src/app/posts/error.tsx
    2. 今回の再読み込みと、境界の再試行は別の操作
    3. エラー画面が担当する範囲
  17. 見つからないページを作る
    1. src/app/not-found.tsx
    2. 通信障害と未存在を、画面でも区別する
  18. CSSで画面を整える
    1. src/app/globals.css
  19. Loadingを意図的に確認する
    1. .env.local
    2. ブラウザーの低速通信設定だけでは不十分な場合がある
  20. Errorを意図的に確認する
    1. .env.local
  21. 存在しない記事を確認する
    1. すべてのエラーを404にしない
  22. Metadataを確認する
    1. Metadataは公開される情報です
  23. 本番ビルドでも確認する
    1. 本番ビルドで見ること
  24. セキュリティと品質を深掘りする
    1. 外部データは、型だけで信用しない
    2. エラーメッセージをそのまま公開しない
    3. 画像やHTMLを追加するときは、別の設計が必要
  25. よくあるつまずきを整理する
  26. 「自力で作れた」を確認する課題
    1. ページをひとつ追加する
    2. 記事一覧の表示件数を変更する
    3. 記事一覧だけを部分的にLoading表示する
    4. API取得処理を別の画面で再利用する
  27. 完成確認シート
  28. Day 50のチェックリスト
  29. まとめ

Day 50:Next.js復習 ― 複数ページ・API取得・Loading・Error・Metadataを備えたWebサイトを自力で作る

Day 50では、これまで学んだNext.jsの基礎を組み合わせ、ひとつのWebサイトを完成させます。テーマは、外部APIの記事データを表示する「学習用記事サイト」です。

今回の目標は、コードを見ながら同じ画面を作ることだけではありません。URLからページを設計し、必要なデータを取得し、待機中・見つからない場合・障害時まで含めて実装できることを目指します。

今回の完成条件を確認する

最初に、「何ができたら完成か」を決めます。

学習項目今回実装するもの完成の確認方法
3ページ以上ホーム、サイト説明、記事一覧、記事詳細それぞれのURLを直接開けます
Dynamic Route/posts/[id]IDごとに別の記事を表示できます
API取得外部APIから記事一覧・詳細を取得固定配列ではなく通信結果を表示します
Loadingloading.tsxデータ取得中に案内を表示できます
Errorerror.tsx取得失敗時にエラー画面を表示できます
Metadata固定ページと記事別の設定ページごとにタイトルが変わります
存在しない記事notFound()とnot-found.tsx存在しないIDを適切に処理できます

ページの数だけでなく、正常時以外の動作も説明できるかが、今回の大切な確認ポイントです。

最初は参考コードを見ずに設計する

復習回では、最初からすべてのコードを写すより、先に構成を考えると理解を確認できます。

まず、次の問いに対する答えをメモします。

  • どのURLが必要ですか。
  • 共通ヘッダーは、どのファイルへ置きますか。
  • API取得は、どこで行いますか。
  • 記事IDは、どこから受け取りますか。
  • ローディング画面は、どのページを囲みますか。
  • 通信障害と記事の未存在を、どう区別しますか。
  • 記事タイトルを、ブラウザーのタブへどう反映しますか。

答えがすぐに出ない部分があっても問題ありません。そこが今回の復習対象です。

自力で取り組むための最小仕様

最初は、次の仕様だけを見て実装に挑戦します。

サイト名:Next.js復習サイト

必要なURL
・/:ホーム
・/about:サイト説明
・/posts:記事一覧
・/posts/[id]:記事詳細

必要な動作
・共通ヘッダーから各ページへ移動できる
・外部APIから記事を取得できる
・一覧から詳細へ移動できる
・取得中は読み込み表示が出る
・取得に失敗するとエラー画面が出る
・存在しない記事は見つからない画面になる
・記事ごとにMetadataが変わる

以降は、実装例と、その設計理由を順番に解説します。

今回の構成と前提を決める

今回は、TypeScript、App Router、srcディレクトリを使用します。また、説明をそろえるため、cacheComponents: trueを有効にしていない構成を前提とします。

データ取得には、学習用REST APIのJSONPlaceholderを使います。このAPIは、登録やAPIキーなしで利用でき、記事の一覧と詳細を取得できます。返ってくる記事は、学習用のダミーデータです。(🔗 jsonplaceholder.typicode.com)

URLとページの対応

URLファイル主な役割
/app/page.tsxサイトの入口
/aboutapp/about/page.tsxサイト説明
/postsapp/posts/page.tsxAPIから記事一覧を取得
/posts/1app/posts/[id]/page.tsxIDに対応する記事を取得

今回は、最低条件の3ページを上回る、4種類のページを作ります。

Server ComponentとClient Componentの分担

ページ、レイアウト、記事カードはServer Componentとして作ります。エラー画面だけはClient Componentにします。

App Routerでは、ページとレイアウトは既定でServer Componentsです。API取得のためだけに"use client"を付ける必要はありません。一方、error.tsxはClient Componentである必要があります。(🔗 nextjs.org)

プロジェクトを準備する

新しく取り組む場合は、次のコマンドで作成します。

# Next.jsのプロジェクトを作成します
npx create-next-app@latest day50-review

# 作成したフォルダーへ移動します
cd day50-review

# サーバー専用モジュールを明示するために追加します
npm install server-only

# 開発サーバーを起動します
npm run dev

作成時は、TypeScript、App Router、srcディレクトリを使用する構成を選びます。今回のCSSは通常のCSSで書くため、Tailwind CSSは必須ではありません。

既存プロジェクトを使う場合は、同じURLに対応する古いファイルが残っていないか確認します。特に、posts/[slug]とposts/[id]を、同じ階層の同じURL位置に重複して作らないようにします。

完成時のファイル構成

今回の主要ファイルは、次の構成です。

src/
├── app/
│   ├── about/
│   │   └── page.tsx
│   ├── posts/
│   │   ├── [id]/
│   │   │   └── page.tsx
│   │   ├── error.tsx
│   │   ├── loading.tsx
│   │   └── page.tsx
│   ├── globals.css
│   ├── layout.tsx
│   ├── not-found.tsx
│   └── page.tsx
├── components/
│   └── PostCard.tsx
├── services/
│   └── post.service.ts
└── types/
    └── post.ts

今回は、Day 49で学んだ役割分担を使いながらも、必要のないフォルダーは増やしません。

  • appはURLと画面を担当します。
  • componentsは表示部品を担当します。
  • servicesはAPIとの通信を担当します。
  • typesは共有するデータの形を定義します。

記事データの型を定義する

最初に、画面で利用する記事の形を決めます。

src/types/post.ts

// 今回の画面で使用する記事データの型です
export type Post = {
  id: number;
  title: string;
  body: string;
};
TypeScript

外部APIには、ほかの項目が含まれている場合もあります。ただし、今回の画面で必要なのは、この3項目です。

型を小さく定義すると、「このサイトはどのデータへ依存しているか」が分かりやすくなります。

型を書くだけでは外部データを検証できない

次のように型を付けても、APIの中身が実際に正しいかを自動検証しているわけではありません。

// この型注釈だけでは、受信データの中身は検証されません
const post: Post = await response.json();
TypeScript

今回は復習を一歩深めるため、APIの結果をいったんunknownとして受け取り、必要な項目を実行時にも確認します。

API取得処理をサービスへまとめる

記事一覧と記事詳細の通信処理をまとめます。

ここでは、次の状態を区別します。

  • 正常に取得できた状態。
  • 詳細APIが404を返し、記事が存在しない状態。
  • 通信障害や、404以外のHTTPエラーが起きた状態。
  • JSONの形が想定と違う状態。

src/services/post.service.ts

// Client Componentからの誤ったimportを防ぎます
import "server-only";

// 共有する記事の型を読み込みます
import type { Post } from "../types/post";

// 通信先は固定し、URL入力などから自由に変更させません
const API_BASE_URL = "https://jsonplaceholder.typicode.com";

// 受信した値が、今回必要な記事の形か確認します
function isPost(value: unknown): value is Post {
  if (typeof value !== "object" || value === null) {
    return false;
  }

  return (
    "id" in value &&
    typeof value.id === "number" &&
    Number.isInteger(value.id) &&
    value.id > 0 &&
    "title" in value &&
    typeof value.title === "string" &&
    "body" in value &&
    typeof value.body === "string"
  );
}

// 学習中だけ使う、待機・エラー確認用の処理です
async function runDevelopmentChecks(): Promise<void> {
  // 本番環境では、この確認処理を実行しません
  if (process.env.NODE_ENV !== "development") {
    return;
  }

  // .env.localで有効にした場合だけ2秒待ちます
  if (process.env.DEMO_SLOW_API === "true") {
    await new Promise<void>((resolve) => {
      setTimeout(resolve, 2000);
    });
  }

  // .env.localで有効にした場合だけ例外を発生させます
  if (process.env.DEMO_API_ERROR === "true") {
    throw new Error("学習用の取得エラーです。");
  }
}

// 記事一覧を取得します
export async function getPosts(): Promise<Post[]> {
  await runDevelopmentChecks();

  const response = await fetch(`${API_BASE_URL}/posts`, {
    // 学習中は、サーバー側のデータキャッシュを使いません
    cache: "no-store",
  });

  // 404を含め、一覧の取得失敗は障害として扱います
  if (!response.ok) {
    throw new Error("記事一覧を取得できませんでした。");
  }

  // 外部から受け取る値は、まずunknownとして扱います
  const data: unknown = await response.json();

  if (!Array.isArray(data)) {
    throw new Error("記事一覧の形式が正しくありません。");
  }

  // 各要素を検証し、画面に必要な項目だけを返します
  return data.map((item: unknown): Post => {
    if (!isPost(item)) {
      throw new Error("記事データの形式が正しくありません。");
    }

    return {
      id: item.id,
      title: item.title,
      body: item.body,
    };
  });
}

// 指定されたIDの記事を取得します
export async function getPostById(
  id: string,
): Promise<Post | null> {
  // 今回は1〜6桁の正の整数だけを受け付けます
  if (!/^[1-9]\d{0,5}$/.test(id)) {
    return null;
  }

  await runDevelopmentChecks();

  const response = await fetch(`${API_BASE_URL}/posts/${id}`, {
    cache: "no-store",
  });

  // 存在しない記事は、障害とは分けて返します
  if (response.status === 404) {
    return null;
  }

  // 404以外の失敗は、エラー画面へ伝える例外にします
  if (!response.ok) {
    throw new Error("記事を取得できませんでした。");
  }

  const data: unknown = await response.json();

  if (!isPost(data)) {
    throw new Error("記事データの形式が正しくありません。");
  }

  return {
    id: data.id,
    title: data.title,
    body: data.body,
  };
}
TypeScript

nullと例外の意味を分ける

今回のgetPostById()は、次の契約です。

戻り方意味ページ側の対応
Postを返す記事を取得できました記事を表示します
nullを返すIDが対象外、または記事がありませんnotFound()を呼びます
例外が発生する通信やデータ形式に問題がありますerror.tsxへ伝わります

APIが落ちている状態を、記事が存在しない状態として扱わないことが重要です。

すべての失敗をnullにすると、通信障害なのに「記事がありません」と表示され、原因を見誤りやすくなります。

fetch()の前後で何が起きるか

このサービスでは、APIへアクセスし、HTTP結果を確認し、JSONを読み取り、内容を検証しています。

Server Componentから呼ぶ非同期処理で例外が発生した場合は、ページの描画へ伝わり、対応するエラー境界で扱えます。データ取得をサービスへ分けても、その流れは変わりません。(🔗 nextjs.org)

共通レイアウトを作る

次に、全ページ共通のヘッダーと本文領域を作ります。

src/app/layout.tsx

// MetadataとReactの型を読み込みます
import type { Metadata } from "next";
import type { ReactNode } from "react";

// 内部リンクと共通CSSを読み込みます
import Link from "next/link";
import "./globals.css";

// サイト全体の既定Metadataです
export const metadata: Metadata = {
  title: {
    default: "Next.js復習サイト",
    template: "%s | Next.js復習サイト",
  },
  description:
    "複数ページ、API取得、Loading、Error、Metadataを学ぶ復習サイトです。",
};

// 全ページ共通のレイアウトです
export default function RootLayout({
  children,
}: {
  children: ReactNode;
}) {
  return (
    <html lang="ja">
      <body>
        <header className="site-header">
          <div className="container header-inner">
            <Link className="site-logo" href="/">
              Next.js復習サイト
            </Link>

            <nav aria-label="メインメニュー">
              <ul className="nav-list">
                <li>
                  <Link href="/">ホーム</Link>
                </li>
                <li>
                  <Link href="/about">サイト説明</Link>
                </li>
                <li>
                  {/* 確認しやすいよう、このリンクの事前取得を無効にします */}
                  <Link href="/posts" prefetch={false}>
                    記事一覧
                  </Link>
                </li>
              </ul>
            </nav>
          </div>
        </header>

        {/* 各ページではmainを重ねず、sectionやarticleを使います */}
        <main className="container main-content">
          {children}
        </main>

        <footer className="site-footer">
          <div className="container">
            <small>Day 50:Next.js基礎の総復習</small>
          </div>
        </footer>
      </body>
    </html>
  );
}
TSX

通常、内部移動にはLinkを使います。Next.jsの事前取得によって読み込み待ちが短くなる場合がありますが、今回はローディング確認のため、一部のリンクでprefetch={false}を指定します。(🔗 nextjs.org)

これは学習用の選択であり、公開サイトで常に事前取得を無効にすべき、という意味ではありません。

ホームページを作る

src/app/page.tsx

// 内部リンクを読み込みます
import Link from "next/link";

// ホームページです
export default function HomePage() {
  return (
    <section className="panel">
      <h1>Next.jsでWebサイトを作る</h1>

      <p>
        このサイトは、Next.jsの基礎機能を組み合わせた復習作品です。
      </p>

      <p>
        記事一覧では外部APIから取得した記事を確認できます。
      </p>

      {/* 記事一覧への入口です */}
      <Link className="button" href="/posts" prefetch={false}>
        記事一覧を見る
      </Link>
    </section>
  );
}
TSX

ホームでは、RootLayoutの既定タイトルを使用します。

このように、すべてのページで無理にMetadataを重複させず、共通の設定と個別の設定を分けます。

サイト説明ページを作る

src/app/about/page.tsx

// Metadataの型を読み込みます
import type { Metadata } from "next";

// 固定ページ用のMetadataです
export const metadata: Metadata = {
  title: "サイト説明",
  description:
    "この復習サイトの目的と、実装しているNext.jsの機能を紹介します。",
};

// サイト説明ページです
export default function AboutPage() {
  return (
    <section className="panel">
      <h1>このサイトについて</h1>

      <p>
        Next.js App Routerを使い、Webサイトを構築する練習をしています。
      </p>

      <ul>
        <li>複数ページの作成</li>
        <li>動的ルートによる記事詳細</li>
        <li>外部APIからのデータ取得</li>
        <li>読み込み中とエラー時の表示</li>
        <li>ページごとのMetadata設定</li>
      </ul>

      <p>
        表示される記事は、外部APIが提供する学習用のダミーデータです。
      </p>
    </section>
  );
}
TSX

固定の説明文なら、generateMetadata()ではなく、静的なmetadataを使うと簡潔です。Next.jsは、これらの定義からページのMetadataを生成します。(🔗 nextjs.org)

記事カードを作る

一覧ページでは、記事1件分の表示をコンポーネントへ分けます。

src/components/PostCard.tsx

// リンクと記事の型を読み込みます
import Link from "next/link";
import type { Post } from "../types/post";

// 記事カードのPropsです
type PostCardProps = {
  post: Post;
};

// 記事1件を表示する部品です
export default function PostCard({ post }: PostCardProps) {
  // 一覧では本文の一部だけを表示します
  const excerpt =
    post.body.length > 100
      ? `${post.body.slice(0, 100)}…`
      : post.body;

  return (
    <article className="post-card">
      <p className="muted">記事ID:{post.id}</p>

      <h2>
        <Link href={`/posts/${post.id}`} prefetch={false}>
          {post.title}
        </Link>
      </h2>

      <p>{excerpt}</p>

      <Link href={`/posts/${post.id}`} prefetch={false}>
        記事を読む
      </Link>
    </article>
  );
}
TSX

記事カードは、APIを呼んでいません。

親から受け取った記事を表示する役割に絞ることで、一覧以外の場所でも使いやすくなります。

記事一覧ページでAPIを取得する

src/app/posts/page.tsx

// Metadata、表示部品、取得処理を読み込みます
import type { Metadata } from "next";
import PostCard from "../../components/PostCard";
import { getPosts } from "../../services/post.service";

// 記事一覧ページのMetadataです
export const metadata: Metadata = {
  title: "記事一覧",
  description:
    "外部APIから取得した学習用の記事を一覧で表示します。",
};

// Server Componentをasyncにしてデータを取得します
export default async function PostsPage() {
  const posts = await getPosts();

  // 学習中は、表示量を抑えるため先頭10件だけ使います
  const visiblePosts = posts.slice(0, 10);

  return (
    <section>
      <header className="page-heading">
        <h1>記事一覧</h1>
        <p>外部APIから取得した記事を表示しています。</p>
        <p>表示件数:{visiblePosts.length}件</p>
      </header>

      {visiblePosts.length === 0 ? (
        <p>表示できる記事はありません。</p>
      ) : (
        <ul className="post-list">
          {visiblePosts.map((post) => (
            <li key={post.id}>
              <PostCard post={post} />
            </li>
          ))}
        </ul>
      )}
    </section>
  );
}
TSX

ページをasyncにし、サービスをawaitしてから表示しています。Server Componentでは、この形でデータ取得できます。(🔗 nextjs.org)

表示件数と取得件数は違う

今回のslice(0, 10)は、取得後に表示件数を減らしているだけです。

通信するデータ量を10件分に減らしているわけではありません。実際のAPIに件数制限やページネーションの仕様がある場合は、その仕様に合わせて必要な量だけ取得する設計へ変更します。

また、今回は表示対象の先頭10件を「最新記事」とは呼んでいません。並び順の根拠となる公開日などを扱っていないためです。

Dynamic Routeで記事詳細を作る

ここでは、URLのIDを使って1件の記事を取得します。

src/app/posts/[id]/page.tsx

// Metadata、リンク、404処理を読み込みます
import type { Metadata } from "next";
import Link from "next/link";
import { notFound } from "next/navigation";

// 記事取得サービスを読み込みます
import { getPostById } from "../../../services/post.service";

// URLパラメータの型です
type PostDetailPageProps = {
  params: Promise<{
    id: string;
  }>;
};

// 記事の内容からMetadataを生成します
export async function generateMetadata({
  params,
}: PostDetailPageProps): Promise<Metadata> {
  const { id } = await params;
  const post = await getPostById(id);

  // 記事がなければ、見つからない画面へ切り替えます
  if (!post) {
    notFound();
  }

  return {
    title: post.title,
    description: post.body.replace(/\s+/g, " ").slice(0, 120),
  };
}

// 記事詳細ページです
export default async function PostDetailPage({
  params,
}: PostDetailPageProps) {
  // /posts/1ならidは"1"になります
  const { id } = await params;

  const post = await getPostById(id);

  if (!post) {
    notFound();
  }

  return (
    <article className="panel">
      <p>
        <Link href="/posts">← 記事一覧へ</Link>
      </p>

      <header className="page-heading">
        <p className="muted">記事ID:{post.id}</p>
        <h1>{post.title}</h1>
      </header>

      {/* 改行はCSSで保持し、本文は文字列として表示します */}
      <p className="article-body">{post.body}</p>
    </article>
  );
}
TSX

[id]とparams.idを対応させる

[id]というフォルダー名を使っているため、ページはparamsからidを受け取ります。

今回のように、URLパラメータを使って取得した記事からMetadataを作る場合は、generateMetadata()を利用できます。paramsはPromiseとして扱い、awaitで読み取ります。(🔗 nextjs.org)

Metadataと本文で取得処理がある理由

Metadataには記事タイトルが必要で、本文には記事の内容が必要です。そのため、両方から同じ取得関数を呼んでいます。

Next.jsでは、同じデータを取得する同一のfetchリクエストについて、MetadataとServer Componentsなどの間でメモ化される仕組みがあります。ただし、自作関数内のすべての処理が自動で1回になる、という意味ではありません。データベースへ変更した場合などは、取得方法に応じて見直します。(🔗 nextjs.org)

Loading UIを追加する

記事一覧と、その下の記事詳細を待つ間に表示するUIを作ります。

src/app/posts/loading.tsx

// 記事ページ配下の読み込み中に表示します
export default function Loading() {
  return (
    <section className="panel">
      <h1>記事を読み込んでいます</h1>

      {/* 読み込み状態をテキストで伝えます */}
      <p role="status">データを取得しています。しばらくお待ちください。</p>

      {/* 装飾用のダミー表示は読み上げ対象から外します */}
      <div className="skeleton-list" aria-hidden="true">
        <div className="skeleton-line" />
        <div className="skeleton-line" />
        <div className="skeleton-line" />
      </div>
    </section>
  );
}
TSX

loading.tsxは、そのセグメントのページと子要素に対するSuspense境界を自動的に用意します。今回はpostsの下へ置くため、記事一覧と記事詳細に対する読み込みUIとして利用できます。(🔗 nextjs.org)

ローディングが見えないこともある

通信が速い場合や、画面のデータがすでに準備されている場合は、ローディング表示が一瞬だけになることがあります。

表示が長く見えないこと自体は、不具合とは限りません。 後ほど学習用の待機処理を使い、意図的に確認します。

Suspenseを追加するなら、待つ場所を内側へ移す

今回のページ全体の待機には、loading.tsxで対応しています。

将来、「見出しを先に表示し、記事一覧だけ待たせたい」場合は、記事取得を子コンポーネントへ移し、その子をSuspenseで囲みます。

親ページで取得をすべてawaitしてからSuspenseを返しても、その前の待ち時間を内側のfallbackでは扱えません。待つ処理を、境界の内側へ配置することが重要です。(🔗 nextjs.org)

エラー画面を追加する

API取得が失敗したときの表示を作ります。

今回は、エラー境界の再試行用propsのバージョン差に依存しないよう、ブラウザーからページを再読み込みする方式にします。

src/app/posts/error.tsx

// エラー画面はClient Componentとして作ります
"use client";

// 記事ページ配下の予期しないエラーを表示します
export default function PostsError() {
  return (
    <section className="panel" aria-labelledby="error-heading">
      <h1 id="error-heading">記事を表示できませんでした</h1>

      <p role="alert">
        通信環境を確認し、時間をおいてもう一度お試しください。
      </p>

      {/* 文書全体を再読み込みし、新しく取得し直します */}
      <button
        className="button"
        type="button"
        onClick={() => window.location.reload()}
      >
        ページを再読み込みする
      </button>
    </section>
  );
}
TSX

windowはブラウザーの機能ですが、ここではクリック時のイベントハンドラー内で実行しています。

今回の再読み込みと、境界の再試行は別の操作

今回のボタンは、文書全体を再読み込みします。エラー境界だけを回復させる操作ではありません。

Next.jsのエラー境界には再試行の仕組みもありますが、対応するpropsは利用バージョンの仕様で確認します。reset、retryなどを、同じ機能だからという理由だけで任意に名前変更して受け取れるわけではありません。 現行の公式リファレンスでも、エラー境界のpropsとして提供される名前が定義されています。(🔗 nextjs.org)

エラー画面が担当する範囲

posts/error.tsxは、記事ページとその配下で発生した、対応範囲内の予期しない描画エラーを扱います。

同じセグメントのlayout.tsxより内側に置かれるため、そのレイアウト自体のエラーまで何でも捕まえるわけではありません。また、クリック処理の例外をすべて自動で扱う仕組みでもありません。(🔗 nextjs.org)

今回は共通レイアウトへAPI取得を置かず、記事ページ側から取得することで、失敗する範囲を分かりやすくしています。

見つからないページを作る

src/app/not-found.tsx

// 戻り先のリンクを読み込みます
import Link from "next/link";

// 記事などが見つからない場合の画面です
export default function NotFound() {
  return (
    <section className="panel">
      <h1>ページが見つかりません</h1>

      <p>
        指定された記事やページは存在しない可能性があります。
      </p>

      {/* 利用者が次の操作を選べるようにします */}
      <Link className="button" href="/posts">
        記事一覧へ戻る
      </Link>
    </section>
  );
}
TSX

notFound()は、通常の値を返す関数ではなく、描画を中断して見つからないUIへ切り替える仕組みです。そのため、不用意なtry...catchで囲んで握りつぶさないようにします。(🔗 nextjs.org)

通信障害と未存在を、画面でも区別する

状態表示する画面案内する内容
記事が存在しませんnot-found.tsx別の記事へ移動してください
API取得に失敗しましたerror.tsx時間をおいて再試行してください
API取得中ですloading.tsxデータを取得しています

同じ「記事が表示できない」状態でも、利用者に案内すべき次の行動が違います。

CSSで画面を整える

機能確認を優先し、少量のCSSで読みやすい表示を作ります。

src/app/globals.css

/* 幅の計算へpaddingとborderを含めます */
* {
  box-sizing: border-box;
}

/* ページ全体の基本設定です */
body {
  margin: 0;
  color: #1f2937;
  background: #f8fafc;
  font-family: sans-serif;
  line-height: 1.8;
}

/* リンクを見分けやすくします */
a {
  color: #1d4ed8;
  text-underline-offset: 0.2em;
}

/* キーボード操作中の位置を明示します */
a:focus-visible,
button:focus-visible {
  outline: 3px solid #f59e0b;
  outline-offset: 4px;
}

/* 共通の横幅です */
.container {
  width: min(100% - 32px, 1000px);
  margin-inline: auto;
}

/* ヘッダーです */
.site-header {
  background: #ffffff;
  border-bottom: 1px solid #cbd5e1;
}

.header-inner {
  display: flex;
  align-items: center;
  justify-content: space-between;
  flex-wrap: wrap;
  gap: 16px;
  padding-block: 20px;
}

.site-logo {
  color: #111827;
  font-weight: 700;
  text-decoration: none;
}

.nav-list {
  display: flex;
  flex-wrap: wrap;
  gap: 16px;
  margin: 0;
  padding: 0;
  list-style: none;
}

/* 本文領域です */
.main-content {
  min-height: 70vh;
  padding-block: 40px;
}

h1,
h2 {
  line-height: 1.5;
  overflow-wrap: anywhere;
}

h1 {
  margin-top: 0;
}

.page-heading {
  margin-bottom: 24px;
}

/* 白いパネルです */
.panel {
  padding: 24px;
  background: #ffffff;
  border: 1px solid #cbd5e1;
  border-radius: 12px;
}

/* 記事一覧です */
.post-list {
  display: grid;
  grid-template-columns: repeat(2, minmax(0, 1fr));
  gap: 20px;
  margin: 0;
  padding: 0;
  list-style: none;
}

.post-card {
  height: 100%;
  padding: 24px;
  background: #ffffff;
  border: 1px solid #cbd5e1;
  border-radius: 12px;
  overflow-wrap: anywhere;
}

.post-card h2 {
  font-size: 1.2rem;
}

.muted {
  color: #475569;
}

/* API本文の改行を保持します */
.article-body {
  white-space: pre-wrap;
  overflow-wrap: anywhere;
}

/* リンクとボタンの共通表示です */
.button {
  display: inline-block;
  padding: 10px 16px;
  color: #ffffff;
  background: #1d4ed8;
  border: 1px solid #1d4ed8;
  border-radius: 6px;
  font: inherit;
  text-decoration: none;
  cursor: pointer;
}

/* 軽量なスケルトン表示です */
.skeleton-list {
  display: grid;
  gap: 12px;
  margin-top: 24px;
}

.skeleton-line {
  height: 24px;
  background: #e2e8f0;
  border-radius: 6px;
}

.skeleton-line:last-child {
  width: 70%;
}

/* フッターです */
.site-footer {
  padding-block: 24px;
  color: #475569;
  border-top: 1px solid #cbd5e1;
}

/* 狭い画面では記事を1列にします */
@media (max-width: 640px) {
  .post-list {
    grid-template-columns: 1fr;
  }
}

ここまでで、基本機能の実装は完了です。

Loadingを意図的に確認する

今回はサービスに、開発環境だけで動く待機処理を用意しました。

プロジェクトルートの.env.localへ、次の設定を追加します。

.env.local

# 開発環境でAPI処理の前に2秒待ちます
DEMO_SLOW_API=true

# エラー確認は、まだ有効にしません
DEMO_API_ERROR=false

設定後は、開発サーバーを再起動します。

# 環境変数の変更を反映するため、停止後に再起動します
npm run dev

ホームから記事一覧へ移動し、読み込み表示を確認します。

ブラウザーの低速通信設定だけでは不十分な場合がある

今回の外部API通信は、ブラウザーではなくNext.jsのサーバー側で実行します。

そのため、ブラウザー側の通信速度制限だけで、サーバーから外部APIへの通信まで同じように遅くなるとは限りません。今回はサーバー側で待機する処理を使い、確認条件をそろえています。

Errorを意図的に確認する

次に、設定を変更します。

.env.local

# 待機の後にエラーになる状態を確認します
DEMO_SLOW_API=true

# 開発環境で学習用エラーを発生させます
DEMO_API_ERROR=true

開発サーバーを再起動し、記事一覧を開きます。

  • 読み込み中の表示を確認します。
  • その後、エラー画面へ切り替わることを確認します。
  • ホームやサイト説明など、API取得を行わないページは開けるか確認します。
  • 確認後はDEMO_API_ERROR=falseへ戻します。
  • 開発サーバーを再起動し、再読み込みで正常表示へ戻るか確認します。

エラーを発生させる設定が有効なままなら、再試行しても再び失敗します。 再試行ボタンは原因そのものを修正するものではありません。

開発中は、エラー画面に加えて開発用のオーバーレイが表示される場合もあります。公開時の表示は、本番ビルドでも別途確認します。

存在しない記事を確認する

エラー確認設定を解除したうえで、次のURLを試します。

http://localhost:3000/posts/abc

http://localhost:3000/posts/0
http://localhost:3000/posts/999999

abcと0は、今回のIDルールに合わないため、APIへ問い合わせずに見つからない扱いになります。

999999はIDの形式には合うため、APIへ問い合わせます。APIが404を返した場合に、見つからない画面へ切り替わります。

すべてのエラーを404にしない

次のような書き方は、今回は採用しません。

// 避けたい例です。通信障害まで「未存在」に変えてしまいます
async function getPostIncorrectly(id: string) {
  try {
    const response = await fetch(
      `https://jsonplaceholder.typicode.com/posts/${id}`,
    );

    return await response.json();
  } catch {
    // 通信障害なのか記事未存在なのかを区別できません
    return null;
  }
}
TypeScript

「取得できなかった」と「存在しなかった」を区別することで、利用者への案内も、開発時の調査も正確になります。

Metadataを確認する

ブラウザーで各ページを開き、タブのタイトルを確認します。

ページ期待するタイトル
ホームNext.js復習サイト
サイト説明`サイト説明
記事一覧`記事一覧
記事詳細`取得した記事タイトル

記事詳細では、APIから取得した本文の一部をdescriptionへ使っています。

これは学習用の簡易的な実装です。実際のブログでは、記事ごとに要約文を管理したほうが、説明文の内容を調整しやすくなります。

Metadataは公開される情報です

generateMetadata()がサーバーで動くからといって、返した内容が秘密になるわけではありません。

Metadataは最終的にブラウザーや検索エンジンへ届く情報です。APIキー、非公開メモ、内部管理情報を含めないようにします。Metadataの生成方法と公開先を分けて考えることが重要です。(🔗 nextjs.org)

本番ビルドでも確認する

開発中に動作したら、本番用のビルドを確認します。

# TypeScriptの整合性を確認します
npx tsc --noEmit

# 本番用にビルドします
npm run build

# ビルド成功後、本番用サーバーを起動します
npm run start

今回は外部APIへリクエスト時にアクセスする構成です。Node.jsで動くNext.jsサーバーなど、サーバー側処理を実行できる公開環境を想定します。

学習用の待機とエラー発生処理は、NODE_ENVが開発環境でない場合には実行されません。

本番ビルドで見ること

  • すべてのページを直接開けますか。
  • 記事一覧から詳細へ移動できますか。
  • 存在しない記事を開いたときに案内が表示されますか。
  • ページごとのタイトルは変わりますか。
  • 小さい画面でも内容が読めますか。
  • キーボードだけでもリンクやボタンを操作できますか。

コードを掲載どおりに用意することと、その環境で動作確認を終えることは別です。最後は必ず実際の画面で確かめます。

セキュリティと品質を深掘りする

外部データは、型だけで信用しない

今回はunknownとisPost()で、必要なデータ形式を検証しました。

これにより、予想していた配列がオブジェクトへ変わった場合や、記事タイトルが文字列ではなかった場合などに、想定外のまま表示処理を進めない構成にしています。

ただし、この検証は包括的な入力制限や認証の代わりではありません。実際のAPI連携では、データ量、文字数、タイムアウト、利用制限なども別途検討します。

エラーメッセージをそのまま公開しない

今回のerror.tsxでは、受け取った内部エラーの内容を画面に表示していません。

利用者には復旧のための案内を表示し、調査用の詳細情報は適切なサーバーログや監視基盤で扱うようにします。Next.jsも、本番のServer Componentエラーでは、機密情報の漏えいを避けるため、クライアントへ渡す情報を制限します。(🔗 nextjs.org)

画像やHTMLを追加するときは、別の設計が必要

今回は、記事本文を通常の文字列として表示しています。

本文を装飾したい場合

まずは、見出しや段落をデータとして分け、Reactの要素で組み立てる方法を検討します。

外部APIからHTMLが届く場合

文字列表示とは異なり、HTMLをどう検証し、どの要素を許可するかを考える必要があります。

最低限の確認事項

外部の本文を見栄えよくするためだけに、未検証の値をdangerouslySetInnerHTMLへ渡さないようにします。今回の学習範囲では、文字列として表示する構成を維持します。

よくあるつまずきを整理する

症状主な確認箇所修正の考え方
awaitでエラーになるページや関数にasyncがあるか非同期処理を行う関数を確認します
詳細ページが開けない[id]とparams.id名前を一致させます
API障害なのに404になるエラーを全部nullにしていないか404と通信障害を分けます
Loadingが一瞬しか見えない通信速度や事前取得学習用待機で確認します
Error画面が出ない例外を握りつぶしていないか例外が境界へ伝わるか確認します
再読み込みしても失敗する強制エラー設定原因を解除してから試します
Metadataが設定できないページに"use client"がないか操作部品だけをClient化します
ファイル移動後にimportエラーになる相対パス読み込み元からの位置を確認します
古いコードが動いているように見える重複ファイルや実行フォルダー使用中のファイルとサーバーを確認します

「自力で作れた」を確認する課題

ここからは、参考コードを閉じて取り組みます。

ページをひとつ追加する

/guideという使い方ページを追加し、共通メニューへリンクを設定します。

  • 必要なフォルダーとファイルを判断します。
  • 固定のMetadataを設定します。
  • URLを直接開いて確認します。

記事一覧の表示件数を変更する

表示件数を10件から5件へ変更します。

そのうえで、「表示件数を減らしたことで通信量も減ったか」を説明します。今回のコードでは、取得後に表示を絞っているため、同じ意味にはなりません。

記事一覧だけを部分的にLoading表示する

一覧の見出しを先に表示し、記事カードの部分だけをSuspenseで待たせる構成へ変更します。

このとき、取得処理をどのコンポーネントへ移すべきか考えます。

API取得処理を別の画面で再利用する

ホームにもおすすめ記事を3件表示します。

既存のgetPosts()とPostCardを使い、データ取得と表示部品を再利用できるか確認します。ホームにもAPI取得が加わるため、ホームの待機中と障害時の扱いも見直します。

完成確認シート

実装後は、次の項目を確認します。

確認対象合格の目安
ページ構成URLからファイルの場所を説明できます
Dynamic RouteURLのIDで表示記事が変わります
API取得通信、HTTP確認、JSON検証の流れを説明できます
Loadingなぜその場所に表示されるか説明できます
Error例外を発生させ、専用画面を確認できます
未存在通信障害と区別して処理できます
Metadata固定設定と動的設定を使い分けられます
設計ページ、表示部品、サービスの役割を説明できます
検証開発環境と本番ビルドの両方を確認できます
自力での変更新しいページや小さな機能を追加できます

Day 50のチェックリスト

  • 3ページ以上のサイトを構築できました。
  • 共通レイアウトと個別ページを分けられました。
  • Dynamic Routeからパラメータを取得できました。
  • Server Componentから外部APIを取得できました。
  • 外部データを実行時に検証できました。
  • LoadingとErrorを意図的に確認できました。
  • 記事未存在と通信障害を区別できました。
  • 記事ごとのMetadataを設定できました。
  • 本番ビルドを確認できました。
  • 参考コードなしで、小さな変更を加えられました。

まとめ

Day 50では、ホーム、サイト説明、記事一覧、記事詳細を作り、Dynamic Route、外部API取得、Loading、Error、Metadataをひとつのサイトへまとめました。

特に重要なのは、成功したときの画面だけでなく、待っているとき・存在しないとき・失敗したときまで設計することです。これらを区別できると、単に表示できるだけではない、利用者を案内できるサイトになります。

「自力で構築できる」とは、すべてのコードを暗記することではありません。必要な機能を分解し、実装する場所を決め、仕様を確認しながら作り、動作を検証できることです。今回の構成を土台に、参考コードを閉じてもページ追加や表示変更ができれば、Next.js基礎の大きな到達点です。

タイトルとURLをコピーしました