エラーハンドリング — try/catch/finally・カスタムエラー・非同期のエラー

try {
  const data = JSON.parse('壊れたJSON'); // ここで例外が発生
  console.log(data); // 実行されない
} catch (error) {
  console.log('パースに失敗しました'); // ここが実行される
}
 
console.log('処理は続行する'); // catch で受け止めたので、ここも実行される

try {
  null.toUpperCase(); // null にメソッドはない → TypeError
} catch (error) {
  console.log(error.name); // "TypeError"
  console.log(error.message); // "Cannot read properties of null (reading 'toUpperCase')"
  console.log(error.stack); // 呼び出し履歴（複数行の文字列）
}

function isValidJson(text) {
  try {
    JSON.parse(text);
    return true;
  } catch {
    // error を使わないので括弧ごと省略できる
    return false;
  }
}

// 値の型がおかしい → TypeError
function double(n) {
  if (typeof n !== 'number') {
    throw new TypeError(`数値が必要です: ${typeof n}`);
  }
  return n * 2;
}
 
// 範囲がおかしい → RangeError
function setVolume(v) {
  if (v < 0 || v > 100) {
    throw new RangeError(`音量は0〜100です: ${v}`);
  }
}

function loadData() {
  showSpinner(); // ローディング開始
  try {
    const data = fetchSync();
    render(data);
  } catch (error) {
    showError(error.message);
  } finally {
    hideSpinner(); // 成功しても失敗しても、必ずスピナーを消す
  }
}

function loadConfig(path) {
  try {
    return readFile(path);
  } catch (error) {
    // ここでログだけ残して、判断は呼び出し元に委ねる
    console.error(`設定ファイルの読み込みに失敗: ${path}`, error);
    throw error; // 再スロー：握りつぶさず上へ伝える
  }
}

// ❌ アンチパターン：エラーを握りつぶす
try {
  saveToServer(data);
} catch {
  // 何もしない → 保存に失敗しても誰も気づけない
}

class ValidationError extends Error {
  constructor(message, field) {
    super(message); // 親 Error の初期化（message をセット）
    this.name = 'ValidationError'; // name は自分で設定する
    this.field = field; // 独自の情報を持たせられる
  }
}
 
throw new ValidationError('メールアドレスの形式が不正です', 'email');

try {
  validateForm(input);
} catch (error) {
  if (error instanceof ValidationError) {
    // 入力ミス → その項目にエラー表示
    highlightField(error.field, error.message);
  } else {
    // それ以外 → 想定外なので上へ投げ直す
    throw error;
  }
}

async function loadUser(id) {
  try {
    return await fetchUser(id);
  } catch (error) {
    // 元のエラーを cause に残しつつ、文脈を足して投げ直す
    throw new Error(`ユーザー(${id})の取得に失敗しました`, { cause: error });
  }
}

async function showUser(id) {
  try {
    const res = await fetch(`/api/users/${id}`);
    if (!res.ok) {
      // fetch は404でも reject しない → 自分で throw する
      throw new Error(`HTTP ${res.status}`);
    }
    const user = await res.json();
    render(user);
  } catch (error) {
    showError(`読み込みに失敗しました: ${error.message}`);
  }
}

fetch('/api/users/1')
  .then((res) => res.json())
  .then((user) => render(user))
  .catch((error) => showError(error.message)); // どこで失敗してもここに来る

// all：1つでも失敗したら catch に飛ぶ（成功した分の結果も受け取れない）
try {
  const [a, b] = await Promise.all([fetchA(), fetchB()]);
} catch (error) {
  console.error('どれかが失敗しました', error);
}
 
// allSettled：失敗しても止めず、成功分だけ拾いたいとき
const results = await Promise.allSettled([fetchA(), fetchB()]);
const ok = results.filter((r) => r.status === 'fulfilled').map((r) => r.value);

// ❌ await がない → reject が catch に捕まらない
async function bad() {
  try {
    saveToServer(data); // Promise を投げっぱなし（await なし）
  } catch (error) {
    // ここには来ない！未処理のまま外に漏れる
  }
}
 
// ⭕ await を付ければ、失敗はその行で例外になり catch に入る
async function good() {
  try {
    await saveToServer(data);
  } catch (error) {
    showError(error.message);
  }
}

// ❌ setTimeout の中のエラーは、この try では捕まえられない
try {
  setTimeout(() => {
    throw new Error('遅れて発生'); // どこにも捕まらず未処理に
  }, 1000);
} catch (error) {
  // ここには来ない
}

try {
  doSomething();
} catch (error) {
  const message = error instanceof Error ? error.message : String(error);
  showError(message);
}