基礎から学ぶJavaScript入門 90日コース | 最終制作 - Day 88:エラー処理・改善

JavaScript 90日で身につけるJavaScript
スポンサーリンク
スポンサーリンク

Day 88:エラー処理・改善

Day 88では、アプリが想定外の入力やデータに出会ったときにも、利用者に状況を伝え、できるだけ安全に動き続けられるよう改善します。学習管理アプリを例に、空入力、不正なデータ、通信エラー、記録がない場合を確認します。

エラー処理は、エラーを隠すことではありません。「何が起きたか」「利用者が次に何をすればよいか」を伝え、データの破損や画面の停止を防ぐことが目的です。

エラー処理を見直す順番

  • どんな入力や操作で問題が起きるかを洗い出します。
  • 問題のある値を、保存や画面表示の前に確認します。
  • 問題があれば、利用者に分かる案内を表示します。
  • 通信や保存など、失敗しうる処理を適切に扱います。
  • 正常な場合だけでなく、空・不正・失敗時の動作も試します。

ステップ1:空入力を確認する

学習内容が空欄だったり、空白だけだったりする場合は、記録を作らないようにします。学習時間は数値で、0より大きい値であることを確認します。日付も、文字が入力されているだけでなく、実際に存在する日付か確かめます。

// 学習記録の入力値を確認し、問題があれば案内文を返す
function validateStudyInput({ title, minutes, date }) {
  // 文字列の前後に空白しかない場合も未入力として扱う
  if (typeof title !== "string" || title.trim() === "") {
    return "学習内容を入力してください。";
  }

  const numericMinutes = Number(minutes);

  // 数値でない値、無限大、0以下、小数を受け付けない
  if (
    !Number.isFinite(numericMinutes) ||
    !Number.isInteger(numericMinutes) ||
    numericMinutes <= 0
  ) {
    return "学習時間には1以上の整数を入力してください。";
  }

  // YYYY-MM-DD形式であることを確認する
  if (typeof date !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(date)) {
    return "学習日を正しい形式で入力してください。";
  }

  // 日付として存在するか確認する。例:2月30日は不正
  const [year, month, day] = date.split("-").map(Number);
  const parsedDate = new Date(year, month - 1, day);

  const isRealDate =
    parsedDate.getFullYear() === year &&
    parsedDate.getMonth() === month - 1 &&
    parsedDate.getDate() === day;

  if (!isRealDate) {
    return "実在する学習日を入力してください。";
  }

  // 問題がなければ空文字を返す
  return "";
}
JavaScript

フォーム送信処理では、記録を作る前にこの関数を呼びます。エラーが返ったらメッセージを表示して処理を止め、問題がなければ追加や更新へ進みます。

// フォーム送信時に入力値を確認する例
studyForm.addEventListener("submit", function (event) {
  // フォーム送信によるページ再読み込みを防ぐ
  event.preventDefault();

  const input = {
    title: titleInput.value,
    minutes: minutesInput.value,
    date: dateInput.value
  };

  const errorMessage = validateStudyInput(input);

  if (errorMessage !== "") {
    // どこを直せばよいか分かる案内を表示する
    statusMessage.textContent = errorMessage;
    return;
  }

  // 入力確認に通った値だけを使って、追加・更新の処理へ進む
  statusMessage.textContent = "";
  saveOrUpdateStudyRecord(input);
});
JavaScript

saveOrUpdateStudyRecord()は、Day 86で作った追加・更新処理に合わせて用意する関数名です。すでに別の名前で同じ処理を作っている場合は、その関数を呼び出してください。

ステップ2:保存データが不正な場合に備える

localStorageに保存されている値は、いつも正しいとは限りません。JSONの形式が壊れている場合や、古いバージョンのデータが残っている場合を考慮します。読み込んだデータを確認してから、アプリで使いましょう。

const STORAGE_KEY = "studyRecords";

// localStorageの内容を確認して学習記録の配列を返す
function loadStudyRecords() {
  try {
    const savedText = localStorage.getItem(STORAGE_KEY);

    // 保存データがまだなければ、空の配列を返す
    if (savedText === null) {
      return [];
    }

    const parsedData = JSON.parse(savedText);

    // 配列でなければ、想定外のデータとして扱う
    if (!Array.isArray(parsedData)) {
      return [];
    }

    // 一覧表示や計算に必要な値の形式を確認する
    return parsedData.filter(function (record) {
      return (
        record !== null &&
        typeof record === "object" &&
        typeof record.id === "string" &&
        typeof record.title === "string" &&
        record.title.trim() !== "" &&
        typeof record.minutes === "number" &&
        Number.isFinite(record.minutes) &&
        Number.isInteger(record.minutes) &&
        record.minutes > 0 &&
        typeof record.date === "string"
      );
    }).map(function (record) {
      // 古いデータにnoteがない場合も、文字列として扱えるよう補う
      return {
        ...record,
        note: typeof record.note === "string" ? record.note : ""
      };
    });
  } catch (error) {
    // JSONが壊れている、または保存領域を使えない場合の処理
    console.error("学習記録の読み込みに失敗しました。", error);
    return [];
  }
}
JavaScript

不正なデータを見つけたときに、いきなり保存データ全体を削除するのは避けます。まずは表示や計算に使えるデータだけを採用し、必要なら「一部の記録を読み込めませんでした」と案内します。復旧のために保存データを消す処理を加える場合は、利用者の記録が失われることを明確に知らせてから行います。

ステップ3:保存エラーを扱う

localStorageへの保存は、保存容量の上限やブラウザーの設定などによって失敗する場合があります。保存処理の成否を確認し、失敗を成功として表示しないようにします。

// 学習記録をlocalStorageへ保存し、成功したかを返す
function saveStudyRecords(records) {
  try {
    localStorage.setItem(STORAGE_KEY, JSON.stringify(records));
    return true;
  } catch (error) {
    // 詳細は開発者が確認できるようコンソールに記録する
    console.error("学習記録の保存に失敗しました。", error);
    return false;
  }
}
JavaScript

呼び出す側では、保存に成功した場合と失敗した場合で、利用者向けの案内を分けます。

// 保存結果に応じて利用者へ案内する
const saved = saveStudyRecords(studyRecords);

if (saved) {
  statusMessage.textContent = "学習記録を保存しました。";
} else {
  statusMessage.textContent =
    "記録を保存できませんでした。ブラウザーの保存領域を確認してください。";
}
JavaScript

ステップ4:通信エラーに備える

APIを使うアプリでは、ネットワークに接続できない、サーバーがエラーを返す、受け取ったデータの形式が違う、といった状況が起こりえます。APIを使わない学習管理アプリなら、この項目は該当しません。外部APIを利用するアプリでは、次のように通信中・失敗時の表示を用意します。

// APIから記録や検索結果を取得する例
async function fetchItems() {
  try {
    // 通信中であることを利用者に知らせる
    statusMessage.textContent = "読み込み中です。";

    const response = await fetch("/api/items");

    // fetchはHTTPエラー時に自動で例外を投げないため確認する
    if (!response.ok) {
      throw new Error(`HTTPエラー: ${response.status}`);
    }

    const data = await response.json();

    // アプリが想定するデータ形式か確認する
    if (!Array.isArray(data)) {
      throw new Error("受け取ったデータの形式が正しくありません。");
    }

    statusMessage.textContent = "";
    return data;
  } catch (error) {
    // 利用者には簡潔な案内を表示する
    statusMessage.textContent =
      "データを読み込めませんでした。通信状況を確認して再度お試しください。";

    // 調査に必要な詳細は開発者向けに記録する
    console.error("データ取得エラー:", error);
    return [];
  }
}
JavaScript

利用者向けの画面に、サーバー内部の情報や技術的なエラーの詳細をそのまま表示する必要はありません。利用者には次の行動が分かる案内を出し、開発者向けの詳細はコンソールや適切なログに分けて記録します。

ステップ5:データがない状態を整える

データが0件の状態と、検索条件に一致する記録が0件の状態は、意味が異なります。前者には最初の登録方法を案内し、後者には条件を変える方法を知らせます。

// 現在の全記録と、表示対象の記録に応じて案内を切り替える
function updateEmptyState(visibleRecords) {
  if (studyRecords.length === 0) {
    // アプリ全体にまだ記録がない場合
    emptyMessage.textContent =
      "まだ記録がありません。フォームから最初の学習を登録してください。";
    emptyMessage.hidden = false;
    return;
  }

  if (visibleRecords.length === 0) {
    // 記録はあるが、検索やフィルターに一致しない場合
    emptyMessage.textContent =
      "条件に合う記録がありません。検索語や期間を変更してください。";
    emptyMessage.hidden = false;
    return;
  }

  // 表示できる記録がある場合は空状態の案内を隠す
  emptyMessage.hidden = true;
}
JavaScript

「何も表示されない」だけでは、読み込みに失敗したのか、記録がないのか、検索結果が0件なのかが分かりません。状態を区別して案内することで、利用者が次に何をすればよいか判断しやすくなります。

ステップ6:エラー表示と安全な画面更新を確認する

入力された学習内容やメモを画面に表示するときは、textContentを使います。利用者の入力をHTMLとして直接挿入すると、文字列がHTMLとして解釈される可能性があります。

// 利用者が入力した内容は、文字列として画面に表示する
titleElement.textContent = record.title;
noteElement.textContent = record.note;
JavaScript

また、エラーの案内を出したあと、正常な操作をしたら古いエラーメッセージを消すと、画面が分かりやすくなります。

// 入力が正しい場合に古いエラー表示を消す
statusMessage.textContent = "";
JavaScript

ステップ7:異常な場合をテストする

正常な入力だけでなく、次のようなケースも実際に試します。

  • 学習内容が空欄、または空白だけの場合に登録されないこと。
  • 学習時間に0、負の数、文字列、小数を入力したときに案内されること。
  • 日付を未入力にした場合や、存在しない日付を扱った場合に適切に処理されること。
  • `localStorage`の値が壊れている場合でも、画面が停止しないこと。
  • 記録が0件の場合に、最初の操作を案内すること。
  • 検索結果が0件の場合に、条件を変える案内を表示すること。
  • APIを使う場合、通信失敗やサーバーエラー時に案内を表示すること。

エラーが起きるたびにアプリ全体が止まるのではなく、問題のある操作を止め、ほかの画面操作は続けられるようにするのが目標です。

Day 88のチェックリスト

  • 空入力や空白だけの入力を防いでいますか。
  • 数値や日付など、入力の形式と範囲を確認していますか。
  • 読み込んだ保存データが想定した形か確認していますか。
  • 保存や通信が失敗した場合に、利用者へ案内していますか。
  • 記録がない状態と、検索結果がない状態を区別していますか。
  • エラーの詳細を利用者へ出しすぎず、開発者向けの記録と分けていますか。
  • 利用者の入力をHTMLとして実行させず、文字列として表示していますか。

まとめ

Day 88では、空入力、不正なデータ、通信エラー、記録がない場合を想定して、アプリのエラー処理を見直しました。大切なのは、問題を検出するだけでなく、利用者が直し方や次の操作を理解できるように案内することです。

入力値は保存前に確認し、保存データも読み込み時に検査します。通信を使う場合は、失敗やデータ形式の違いに備えます。正常な場合だけでなく、空・不正・失敗時の操作も試して、安心して使えるアプリに仕上げましょう。

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