エラーハンドリング
try...catch と非同期処理のエラーハンドリング、失敗時の表示
外部から受け取るデータ(JSON、API のレスポンス、localStorage の値など)を扱う処理と通信処理では、try...catch でエラーを捕捉し、1 か所の失敗でページ全体が動かなくならないようにします。
基本パターン
エラーを捕捉したら、処理を続けられる値(null や初期値)を返します。呼び出し側は、その値が返ってくることを前提に表示を切り替えてください。
function parseJSON(str) {
try {
return JSON.parse(str);
} catch {
return null;
}
}
const settings = parseJSON(localStorage.getItem("settings")) ?? DEFAULT_SETTINGS;
非同期処理
非同期処理では async / await を使い、try...catch で囲んでエラーを捕捉します。
- HTTP エラーを確認する:
fetchは HTTP エラー(404 や 500 など)では例外を投げないため、response.okを確認して明示的にエラーにする - タイムアウトを設定する:
AbortSignal.timeout()を指定し、応答がないまま待ち続けないようにする
async function fetchNews(url) {
try {
const response = await fetch(url, { signal: AbortSignal.timeout(10000) });
if (!response.ok) {
throw new Error(`HTTP ${response.status}`);
}
return await response.json();
} catch {
return null;
}
}
return await response.json() の await は省略しないでください。省略すると、JSON の解析で起きたエラーを catch で捕捉できません。
失敗時の表示
エラーを捕捉して何も表示しないと、ユーザーには「読み込み中のまま」や「何も起きない」ように見えます。取得や送信に失敗した場合は、失敗したことと次にできること(再読み込み、時間をおいて再試行、お問い合わせ先など)を画面に表示してください。
async function renderNews(newsList) {
const news = await fetchNews("/api/news.json");
if (news === null) {
newsList.textContent = "お知らせを読み込めませんでした。時間をおいて再読み込みしてください。";
return;
}
// 取得できた場合の表示...
}