ログイン画面とログイン処理

API側の準備ができたので、ここからフロントエンド側の実装に入ります。ログイン画面を作り、フォームの送信・成功時のダッシュボードへのリダイレクト・失敗時のエラー表示までを1つのコンポーネントにまとめます。

1. ログイン画面の実装

フォームは入力状態の管理・送信中フラグ・エラー表示などクライアント側の状態を持つため、Client Component として実装します。

1.1 ログインページの作成

エクスプローラーで app フォルダを右クリックして「新しいフォルダー」で login を作り、その中に page.tsx を作ります。

frontend-login-demo/
├── app/
│   ├── api/
│   ├── lib/
│   ├── login/               ← このフォルダを作成
│   │   └── page.tsx         ← このファイルを作成
│   └── ...
└── ...

作成した app/login/page.tsx に以下の内容を記述して保存します。

"use client";

import { useState } from "react";
import { useRouter } from "next/navigation";

export default function LoginPage() {
  const router = useRouter();
  const [email, setEmail] = useState("alice@example.com");
  const [password, setPassword] = useState("password123");
  const [error, setError] = useState<string | null>(null);
  const [submitting, setSubmitting] = useState(false);

  const handleSubmit = async (event: React.FormEvent) => {
    event.preventDefault();
    setSubmitting(true);
    setError(null);

    const res = await fetch("/api/login", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ email, password }),
    });

    if (!res.ok) {
      const data = await res.json();
      setError(data.error ?? "ログインに失敗しました");
      setSubmitting(false);
      return;
    }

    router.push("/dashboard");
  };

  return (
    <main className="mx-auto max-w-md p-8">
      <h1 className="text-2xl font-bold mb-6">ログイン</h1>
      <form onSubmit={handleSubmit} className="space-y-4">
        <div>
          <label className="block text-sm mb-1">メールアドレス</label>
          <input
            type="email"
            value={email}
            onChange={(e) => setEmail(e.target.value)}
            className="w-full border rounded px-3 py-2"
            required
          />
        </div>
        <div>
          <label className="block text-sm mb-1">パスワード</label>
          <input
            type="password"
            value={password}
            onChange={(e) => setPassword(e.target.value)}
            className="w-full border rounded px-3 py-2"
            required
          />
        </div>
        {error && <p className="text-red-600 text-sm">{error}</p>}
        <button
          type="submit"
          disabled={submitting}
          className="w-full bg-black text-white rounded py-2 disabled:opacity-50"
        >
          {submitting ? "ログイン中..." : "ログイン"}
        </button>
      </form>
    </main>
  );
}

1.2 コードの解説

コードを解説します。

"use client";

このファイルをClient Componentとして扱う宣言です。フォームの入力状態やクリックイベントを扱うためには、ブラウザ側で実行されるコンポーネントである必要があります。

const [email, setEmail] = useState("alice@example.com");
const [password, setPassword] = useState("password123");
const [error, setError] = useState<string | null>(null);
const [submitting, setSubmitting] = useState(false);

フォームの入力値・エラーメッセージ・送信中フラグを、Reactの状態として管理します。email と password の初期値には、認証APIでハードコードした alice@example.com / password123 を入れてあり、フォームを開いてすぐに「ログイン」ボタンを押せば動作確認できるようにしてあります。submitting は連打防止と送信中の表示切り替えに使います。

const res = await fetch("/api/login", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ email, password }),
});

作成した認証APIに、入力されたメールアドレス・パスワードをPOSTします。Next.jsのRoute Handlerと同じオリジン(localhost:3000)へのリクエストのため、レスポンスの Set-Cookie は自動的にブラウザに保存されます。

if (!res.ok) {
  const data = await res.json();
  setError(data.error ?? "ログインに失敗しました");
  setSubmitting(false);
  return;
}

router.push("/dashboard");

res.ok が false(401)なら、APIから返ってきたエラーメッセージを画面に表示します。成功時は useRouter().push("/dashboard") でダッシュボード画面に遷移します。

1.3 動作確認

ログイン画面と認証APIが連携して動くことを、ここで確認します。開発サーバを npm run dev で起動したまま、ブラウザで http://localhost:3000/login を開きます。

「ログイン」の見出し・メールアドレス欄・パスワード欄・「ログイン」ボタンからなる、以下のようなフォームが表示されれば、ログイン画面のレンダリングは動いています。

初期値のまま(alice@example.com / password123)で「ログイン」ボタンを押します。/dashboard に遷移し、以下のように「404」と「This page could not be found.」が表示されれば、フォーム送信 → 認証APIへのPOST → 成功時のリダイレクトまでが動いています。/dashboard はまだ作っていないので、この時点で404になるのが正しい挙動です。

続けて、Cookieがブラウザに正しく保存されているかを確認します。ブラウザのDevTools(macOSは Cmd + Option + I、Windowsは F12)を開き、上部タブから「Application」を選択します。左のサイドバーの「Storage」セクションから「Cookies」→「http://localhost:3000」をクリックし、以下のように token という名前のCookieが表示されていて HttpOnly 列(列幅が狭い場合は Ht... と省略表示されます)にチェックが入っていれば、認証APIから発行されたCookieがブラウザ側でも正しく受け取れています。

最後に、失敗時のエラー表示を確認します。ブラウザで http://localhost:3000/login に戻り、パスワードを wrongpass などの誤った値に書き換えて「ログイン」ボタンを押します。以下のようにフォームの下に赤字で「メールアドレスまたはパスワードが正しくありません」と表示されれば、エラーハンドリングも動いています。

⚠️ ブラウザ拡張機能に起因するエラーが出た場合
動作確認中に、以下のようなエラーがブラウザの開発者コンソールに表示されることがあります。

- A tree hydrated but some attributes of the server rendered HTML didn't match the client properties. (差分に data-google-analytics-opt-out や data-redeviation-bs-uid など、見覚えのない属性が含まれるハイドレーションエラー)
- Uncaught TypeError: Failed to execute 'measure' on 'Performance': 'ページ名' cannot have a negative time stamp. (Next.jsのパフォーマンス計測APIに拡張機能の処理タイミングが干渉して起きるエラー)

いずれも、ブラウザ拡張機能が <html> 要素に独自の属性を差し込んだり、Next.jsの内部処理に割り込んだりすることが原因で、ハンズオンで書いたコード側の問題ではありません。

回避するには、シークレットウィンドウ(macOSは Cmd + Shift + N、Windowsは Ctrl + Shift + N)で http://localhost:3000 を開くと、拡張機能が読み込まれない状態で動作確認できます。