本文へ移動
プログラミング大全動かして、比べて、理解する。

JavaScript / コードを試す

Error と try / catch / finally / throw

Error が持っているもの、throw できるもの、finally が必ず動くこと、JSON にすると空になる理由、 cause で原因を繋ぐ書き方、独自のエラーを作って種類で分ける方法までを実行して確かめます。

固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。

元の教材を読む(別タブ)

コードを編集して試す

ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。

playground.js

8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。

パネルを開くと編集できます。

現在の入力は未実行です。

今回の実行結果
JavaScriptUTF-8 · LF

実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。

Error が持っているのは、種類・文言・スタックトレースの3つです。

example.js

const error = new Error('壊れた');

console.log(error.name);
console.log(error.message);
console.log(String(error));
console.log(typeof error.stack);
固定例の期待出力 · Node 24.22.3
Error
壊れた
Error: 壊れた
string
表示用コードUTF-8 · LF

name と message を : で繋いだものが、文字列にしたときの形です。

組み込みの種類

example.js

for (const Kind of [TypeError, RangeError, SyntaxError, ReferenceError]) {
  const error = new Kind('x');
  console.log(error.name, error instanceof Error);
}
固定例の期待出力 · Node 24.22.3
TypeError true
RangeError true
SyntaxError true
ReferenceError true
表示用コードUTF-8 · LF

すべて Error を継承しています。 だから instanceof Error で一括して受けられます。

よく出る2つは、それぞれ独立したページで扱っています。 → TypeError: x is not a function → SyntaxError: Unexpected token

種類 いつ出るか
TypeError 型が合わない(関数でないものを呼んだ、null の中身を読んだ)
RangeError 値が範囲の外(配列の長さ、toFixed の桁)
ReferenceError 名前が見つからない
SyntaxError 構文として読めない(JSON.parse を含む)

throw できるものは何でも

example.js

for (const value of [new Error('e'), '文字列', 42]) {
  try {
    throw value;
  } catch (caught) {
    console.log(typeof caught, caught instanceof Error);
  }
}
固定例の期待出力 · Node 24.22.3
object true
string false
number false
表示用コードUTF-8 · LF

文字列も数値も投げられます。ですが投げないでください。

Error でないものを投げると、message も stack も付きません。 受け取った側は何が起きたか調べられません。

example.js

function risky(useError) {
  throw useError ? new Error('理由が分かる') : '理由だけ';
}

for (const useError of [true, false]) {
  try {
    risky(useError);
  } catch (error) {
    console.log(error?.message ?? '(message が無い)', '|', typeof error?.stack);
  }
}
固定例の期待出力 · Node 24.22.3
理由が分かる | string
(message が無い) | undefined
表示用コードUTF-8 · LF

finally は必ず動く

example.js

function run(fail) {
  try {
    if (fail) throw new Error('だめ');
    return '成功';
  } catch (error) {
    return '失敗';
  } finally {
    console.log('finally');
  }
}

console.log(run(false));
console.log(run(true));
固定例の期待出力 · Node 24.22.3
finally
成功
finally
失敗
表示用コードUTF-8 · LF

return より後に動きます。 後始末(閉じる・解放する・止める)を書く場所です。

finally の中で return すると、try や catch の結果を上書きします。 書かないでください。

使わない引数は省ける

example.js

try {
  JSON.parse('x');
} catch {
  console.log('中身を見ないなら省略できる');
}
固定例の期待出力 · Node 24.22.3
中身を見ないなら省略できる
表示用コードUTF-8 · LF

JSON にすると空になる

これがいちばん事故になります。

javascript失敗・注意の例

const error = new Error('壊れた');

console.log(JSON.stringify(error));
console.log(Object.keys(error));
固定例の期待出力 · Node 24.22.3
{}
[]
表示用コードUTF-8 · LF

name も message も stack も、列挙されないので消えます。

ログに送ったつもりで {} だけが残る、というのはこれが原因です。 自分で取り出してください。

example.js

function toLog(error) {
  return {
    name: error.name,
    message: error.message,
    stack: typeof error.stack === 'string' ? error.stack.split('\n')[0] : null,
  };
}

console.log(JSON.stringify(toLog(new Error('壊れた'))));
固定例の期待出力 · Node 24.22.3
{"name":"Error","message":"壊れた","stack":"Error: 壊れた"}
表示用コードUTF-8 · LF

→ JSON.parse() と JSON.stringify()

原因を繋ぐ

cause で、元の失敗を保ったまま包み直せます(ES2022)。

example.js

const low = new Error('通信できない');
const high = new Error('ユーザーの取得に失敗', { cause: low });

console.log(high.message);
console.log(high.cause.message);
固定例の期待出力 · Node 24.22.3
ユーザーの取得に失敗
通信できない
表示用コードUTF-8 · LF

握りつぶさずに、文脈だけを足せます。

javascript失敗・注意の例
try {
  JSON.parse('x');
} catch (error) {
  throw new Error('設定を読めません');
}
表示用コードUTF-8 · LF

これだと元の SyntaxError が消えます。cause を付けてください。

独自のエラーを作る

種類で分けたいときに作ります。

example.js

class NotFoundError extends Error {
  constructor(id) {
    super(`見つかりません: ${id}`);
    this.name = 'NotFoundError';
    this.id = id;
  }
}

const error = new NotFoundError(7);

console.log(error.name, error.message, error.id);
console.log(error instanceof NotFoundError, error instanceof Error);
固定例の期待出力 · Node 24.22.3
NotFoundError 見つかりません: 7 7
true true
表示用コードUTF-8 · LF

super(message) を呼び、name を自分で入れます。 → class — 作る・継承する・隠す

受け取る側は種類で分けられます。

example.js

class NotFoundError extends Error {
  constructor(id) {
    super(`見つかりません: ${id}`);
    this.name = 'NotFoundError';
  }
}

function handle(error) {
  if (error instanceof NotFoundError) return '404 として扱う';
  if (error instanceof TypeError) return 'こちらの不具合';
  return '不明';
}

console.log(handle(new NotFoundError(1)));
console.log(handle(new TypeError('x')));
console.log(handle(new Error('x')));
固定例の期待出力 · Node 24.22.3
404 として扱う
こちらの不具合
不明
表示用コードUTF-8 · LF

文言で分岐しないでください。 文言は処理系や版で変わります。 種類(instanceof)か、自分で付けた印(code など)で分けます。

よくある間違い

何でも catch して握りつぶす

javascript失敗・注意の例
try {
  JSON.parse('x');
} catch {
  // 何もしない
}
表示用コードUTF-8 · LF

問題が消えたのではなく、見えなくなっただけです。 記録するか、包んで投げ直すか、どちらかにしてください。

想定外まで受けてしまう

example.js

function parse(text) {
  try {
    return JSON.parse(text);
  } catch (error) {
    if (error instanceof SyntaxError) return null;
    throw error;
  }
}

console.log(parse('{"a":1}'));
console.log(parse('x'));
固定例の期待出力 · Node 24.22.3
{ a: 1 }
null
表示用コードUTF-8 · LF

受けたい種類だけ受け、それ以外は投げ直す。 そうしないと、想定外の不具合まで null に化けます。

失敗したときにやり直す形は、こちらにまとめています。 → 失敗したら再試行する

try の範囲が広すぎる

try に何十行も入れると、どこで失敗したのか分からなくなります。 落ちうる1行だけを囲んでください。

まとめ

  • Error が持つのは種類・文言・スタックトレース
  • 組み込みの種類はすべて Error を継承している
  • Error 以外を投げない。 message も stack も付かない
  • finally は return より後に動く。中で return しない
  • JSON.stringify(error) は {}。 自分で取り出す
  • 包み直すときは cause で元を残す
  • 分岐は文言ではなく種類で

出典

この教材の原文(Markdown・別タブ)