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);
});JavaScriptsaveOrUpdateStudyRecord()は、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では、空入力、不正なデータ、通信エラー、記録がない場合を想定して、アプリのエラー処理を見直しました。大切なのは、問題を検出するだけでなく、利用者が直し方や次の操作を理解できるように案内することです。
入力値は保存前に確認し、保存データも読み込み時に検査します。通信を使う場合は、失敗やデータ形式の違いに備えます。正常な場合だけでなく、空・不正・失敗時の操作も試して、安心して使えるアプリに仕上げましょう。
