JavaScript / コードを試す
Error と try / catch / finally / throw
Error が持っているもの、throw できるもの、finally が必ず動くこと、JSON にすると空になる理由、 cause で原因を繋ぐ書き方、独自のエラーを作って種類で分ける方法までを実行して確かめます。
固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。
コードを編集して試す
ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。
8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。
パネルを開くと編集できます。
現在の入力は未実行です。
入力中のコードをこの例へ置き換えます。
実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。
Error が持っているのは、種類・文言・スタックトレースの3つです。
const error = new Error('壊れた'); console.log(error.name); console.log(error.message); console.log(String(error)); console.log(typeof error.stack);
Error 壊れた Error: 壊れた string
name と message を : で繋いだものが、文字列にしたときの形です。
組み込みの種類
for (const Kind of [TypeError, RangeError, SyntaxError, ReferenceError]) { const error = new Kind('x'); console.log(error.name, error instanceof Error); }
TypeError true RangeError true SyntaxError true ReferenceError true
すべて Error を継承しています。 だから instanceof Error で一括して受けられます。
よく出る2つは、それぞれ独立したページで扱っています。 → TypeError: x is not a function → SyntaxError: Unexpected token
| 種類 | いつ出るか |
|---|---|
TypeError |
型が合わない(関数でないものを呼んだ、null の中身を読んだ) |
RangeError |
値が範囲の外(配列の長さ、toFixed の桁) |
ReferenceError |
名前が見つからない |
SyntaxError |
構文として読めない(JSON.parse を含む) |
throw できるものは何でも
for (const value of [new Error('e'), '文字列', 42]) { try { throw value; } catch (caught) { console.log(typeof caught, caught instanceof Error); } }
object true string false number false
文字列も数値も投げられます。ですが投げないでください。
Error でないものを投げると、message も stack も付きません。
受け取った側は何が起きたか調べられません。
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); } }
理由が分かる | string (message が無い) | undefined
finally は必ず動く
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));
finally 成功 finally 失敗
return より後に動きます。 後始末(閉じる・解放する・止める)を書く場所です。
finally の中で return すると、try や catch の結果を上書きします。
書かないでください。
使わない引数は省ける
try { JSON.parse('x'); } catch { console.log('中身を見ないなら省略できる'); }
中身を見ないなら省略できる
JSON にすると空になる
これがいちばん事故になります。
const error = new Error('壊れた');
console.log(JSON.stringify(error));
console.log(Object.keys(error));{}
[]name も message も stack も、列挙されないので消えます。
ログに送ったつもりで {} だけが残る、というのはこれが原因です。
自分で取り出してください。
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('壊れた'))));
{"name":"Error","message":"壊れた","stack":"Error: 壊れた"}→ JSON.parse() と JSON.stringify()
原因を繋ぐ
cause で、元の失敗を保ったまま包み直せます(ES2022)。
const low = new Error('通信できない'); const high = new Error('ユーザーの取得に失敗', { cause: low }); console.log(high.message); console.log(high.cause.message);
ユーザーの取得に失敗 通信できない
握りつぶさずに、文脈だけを足せます。
try {
JSON.parse('x');
} catch (error) {
throw new Error('設定を読めません');
}これだと元の SyntaxError が消えます。cause を付けてください。
独自のエラーを作る
種類で分けたいときに作ります。
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);
NotFoundError 見つかりません: 7 7 true true
super(message) を呼び、name を自分で入れます。
→ class — 作る・継承する・隠す
受け取る側は種類で分けられます。
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')));
404 として扱う こちらの不具合 不明
文言で分岐しないでください。 文言は処理系や版で変わります。
種類(instanceof)か、自分で付けた印(code など)で分けます。
よくある間違い
何でも catch して握りつぶす
try {
JSON.parse('x');
} catch {
// 何もしない
}問題が消えたのではなく、見えなくなっただけです。 記録するか、包んで投げ直すか、どちらかにしてください。
想定外まで受けてしまう
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'));
{ a: 1 }
null受けたい種類だけ受け、それ以外は投げ直す。
そうしないと、想定外の不具合まで null に化けます。
失敗したときにやり直す形は、こちらにまとめています。 → 失敗したら再試行する
try の範囲が広すぎる
try に何十行も入れると、どこで失敗したのか分からなくなります。
落ちうる1行だけを囲んでください。
まとめ
Errorが持つのは種類・文言・スタックトレース- 組み込みの種類はすべて
Errorを継承している Error以外を投げない。messageもstackも付かないfinallyはreturnより後に動く。中でreturnしないJSON.stringify(error)は{}。 自分で取り出す- 包み直すときは
causeで元を残す - 分岐は文言ではなく種類で