コンテンツにスキップ
開発ガイドライン
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

エラーハンドリング

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;
  }
  // 取得できた場合の表示...
}

このページは役に立ちましたか?