---
title: エラーハンドリング
description: try...catch と非同期処理のエラーハンドリング、失敗時の表示
---

外部から受け取るデータ（JSON、API のレスポンス、`localStorage` の値など）を扱う処理と通信処理では、`try...catch` でエラーを捕捉し、1 か所の失敗でページ全体が動かなくならないようにします。

## 基本パターン

エラーを捕捉したら、処理を続けられる値（`null` や初期値）を返します。呼び出し側は、その値が返ってくることを前提に表示を切り替えてください。

```javascript
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()` を指定し、応答がないまま待ち続けないようにする

```javascript
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` で捕捉できません。

## 失敗時の表示

エラーを捕捉して何も表示しないと、ユーザーには「読み込み中のまま」や「何も起きない」ように見えます。取得や送信に失敗した場合は、失敗したことと次にできること（再読み込み、時間をおいて再試行、お問い合わせ先など）を画面に表示してください。

```javascript
async function renderNews(newsList) {
  const news = await fetchNews("/api/news.json");
  if (news === null) {
    newsList.textContent = "お知らせを読み込めませんでした。時間をおいて再読み込みしてください。";
    return;
  }
  // 取得できた場合の表示...
}
```

:::note[console の使用]
テンプレートの静的解析では、`console` の使用をエラーにしています（ESLint の `no-console`、Biome の `noConsole`）。開発中の確認に使った `console` は、コミット前に削除してください。
:::
