JavaScriptのエラー処理入門|try・catchとErrorの使い方
JavaScript のプログラムは、途中でエラーが起きるとその場で止まります。画面のボタンが急に反応しなくなる原因の多くは、どこかで起きたエラーを誰も受け止めていないことです。エラーを受け止めて、利用者に分かる形で知らせたり、処理を続けたりする仕組みが try・catch・finally と Error オブジェクトです。
この記事では、処理の流れ、エラーの種類とメッセージ、throw、自作のエラークラス、cause、finally の落とし穴を、実際の出力で確かめながら説明します。出力は Windows 11 の Microsoft Edge 155 で実行したものです。
この記事のコードの試し方
コードはブラウザの開発者ツールのコンソールで試せます(インストールは不要です)。
- Edge または Chrome で、どのページでもよいので開いた状態で F12 キーを押します。
- 開いた画面の上部にある「Console(コンソール)」タブを選びます。
- 記事のコードをコピーして貼り付け、Enter キーを押します。
初めて貼り付けるときは、詐欺を防ぐための警告が出て、確認の文字の入力を求められることがあります。知らない人から教えられたコードはコンソールに貼り付けないでください。この記事の例は同じ変数名や関数名を何度も使うので、「already been declared」というエラーが出たら F5 キーで再読み込みしてから貼り直してください。
エラーが起きると、そこで処理が止まる
まず、エラーを受け止めないとどうなるかを見てみます。undefined(値が入っていない状態)の変数から項目を取り出そうとすると、エラーになります。
console.log("1. 開始");
const user = undefined;
console.log(user.name);
console.log("2. ここは実行されない");
1. 開始
Uncaught TypeError: Cannot read properties of undefined (reading 'name')
3 行目でエラーが起き、4 行目の「2. ここは実行されない」は表示されません。Uncaught は「誰にも受け止められなかった」という意味です。このように、プログラムの実行中に起きて、それ以降の処理を中断させるエラーを例外(れいがい)と呼び、例外が起きることを「例外が投げられる(throw)」と言います。
try・catch・finally の基本
エラーが起きるかもしれない処理を try { } で囲み、エラーが起きたときの処理を catch (error) { } に書きます。成功しても失敗しても最後に必ず行う処理は finally { } に書きます。
try {
console.log("1. 開始");
const user = undefined;
console.log(user.name);
console.log("2. ここは飛ばされる");
} catch (error) {
console.log("3. catch:", error.message);
} finally {
console.log("4. finally は必ず実行される");
}
console.log("5. 続きの処理も動く");
1. 開始
3. catch: Cannot read properties of undefined (reading 'name')
4. finally は必ず実行される
5. 続きの処理も動く
try の中でエラーが起きると、残りの行(2.)は飛ばされて、すぐに catch に移ります。catch (error) の error には、起きたエラーの情報(Error オブジェクト)が入ります。エラーを受け止めたので、try の外の「5.」まで処理が続きます。
3 行目を const user = { name: "田中" }; に変えると、「1. 開始」「田中」「finally」と表示され、catch は実行されません(図 1 の右)。

よく出るエラーの種類とメッセージ
JavaScript には、原因ごとにエラーの種類(Error を元にしたもの)が用意されています。Edge 155 で実際に出たメッセージをまとめます(String(error) で「種類: メッセージ」の形にしたものです。文言はブラウザによって違います)。
| 種類 | どんなときに出るか | コードの例 | Edge 155 のメッセージ |
|---|---|---|---|
| TypeError | 値の型(種類)に合わない使い方をした | null の項目を読む | Cannot read properties of null (reading ‘name’) |
| TypeError | 関数でないものを呼び出した | const price = 500; price.toUpperCase(); | price.toUpperCase is not a function |
| ReferenceError | 存在しない変数を使った(打ち間違いなど) | console.log(usre); | usre is not defined |
| RangeError | 値が使える範囲の外 | new Array(-1); | Invalid array length |
| SyntaxError | 文法の間違い(JSON の解析など) | JSON.parse("{"); | Expected property name or ‘}’ in JSON at position 1 (line 1 column 2) |
| URIError | URL のエンコードの形が正しくない | decodeURIComponent("%"); | URI malformed |
いちばんよく見るのは TypeError の「Cannot read properties of undefined (reading ‘…’)」です。「undefined から ‘…’ という項目を読もうとした」という意味なので、( ) の中の項目名の、1 つ手前の値が undefined になっていないかを調べます。JSON の SyntaxError のメッセージの読み方は「JavaScriptのJSON.parseとstringify」で詳しく説明しています。URIError は、URL の「%」のあとの文字が正しくないと出ます。URL のエンコード・デコードの結果を確かめたいときは「URLエンコード・デコードツール」が使えます。
コード自体の文法の間違いは catch できない
SyntaxError には注意点があります。JSON.parse のように実行中に起きる SyntaxError は catch できますが、コードそのものの書き間違いは catch できません。
たとえば try の中に const a = ; と書くと、catch には来ずに「Uncaught SyntaxError: Unexpected token ‘;’」と表示されます。JavaScript は、実行する前にコード全体の文法を確かめます。文法が正しくないと1 行も実行されないので、try も catch も動きません。この種類のエラーは、エラーメッセージの場所を見てコードを直すしかありません。
Error オブジェクトの name・message・stack
catch で受け取った Error オブジェクトからは、次の情報を取り出せます。
try {
const user = null;
user.name;
} catch (error) {
console.log(error.name);
console.log(error.message);
console.log(error instanceof TypeError, error instanceof Error);
console.log(String(error));
}
TypeError
Cannot read properties of null (reading 'name')
true true
TypeError: Cannot read properties of null (reading 'name')
name はエラーの種類の名前、message は説明文です。このほか、関数の呼び出し経路を表す stack と、原因のエラーを表す cause(後で説明)があります。instanceof は「この値は、その種類(クラス)から作られたものか」を調べる演算子です。TypeError は Error を元にした種類なので、instanceof Error も true になります。
stack で「どこから呼ばれたか」が分かる
関数を 3 段階に呼び出す途中でエラーを起こし、stack を表示します。次のコードを app.js というファイル名で読み込んだときの出力です(コンソールで実行すると、ファイル名の部分の表示は変わります)。
function loadUser() {
return null;
}
function showName() {
const user = loadUser();
return user.name;
}
function main() {
showName();
}
try {
main();
} catch (error) {
console.log(error.stack);
}
TypeError: Cannot read properties of null (reading 'name')
at showName (app.js:6:15)
at main (app.js:9:3)
at app.js:12:3
上がエラーの起きた場所、下に行くほど呼び出し元です。「showName の 6 行目 15 文字目で起きた。showName は main の 9 行目から呼ばれ、main は 12 行目から呼ばれた」と読みます。本当の原因は null を返した loadUser ですが、すでに終わっているので stack には出ません。値がどこから来たかをたどるのがこつです。
なお MDN では、stack は主要なブラウザが実装しているものの標準の仕様にはない(Non-standard)とされていて、書式もブラウザごとに違います。不具合の調査のために人が読むものと考えましょう。
throw で自分でエラーを出す
入力された値がおかしいときなど、自分でエラーを起こしたい場合は throw new Error("メッセージ") と書きます。年齢の入力を確かめる関数の例です。
function parseAge(text) {
const age = Number(text);
if (!Number.isInteger(age) || age < 0) {
throw new Error(`年齢は 0 以上の整数で入力してください(入力:${text})`);
}
return age;
}
try {
console.log(parseAge("28"));
console.log(parseAge("abc"));
console.log("ここは実行されない");
} catch (error) {
console.log("エラー:", error.message);
}
28
エラー: 年齢は 0 以上の整数で入力してください(入力:abc)
throw した時点で関数は終わり、return の行には進みません。エラーは呼び出し元へと伝わっていき、途中に try…catch があればそこで受け止められます。どこにもなければ、たとえば try の外で parseAge("-5") を呼ぶと「Uncaught Error: 年齢は 0 以上の整数で入力してください(入力:-5)」と表示されて止まります。
メッセージには、何が悪かったのか(入力された値)と、どうすればよいかを入れておくと、後で原因を探すときに助かります。
標準の種類も自分で投げられます。型が違うなら throw new TypeError("…")、範囲の外なら throw new RangeError("…") のように使い分けると、受け取る側が種類で分けられます。
throw “文字列” をしてはいけない理由
throw のあとには、実は何でも書けます。throw "在庫がありません"; のように文字列を投げることもできますが、おすすめしません。
try {
throw "在庫がありません";
} catch (error) {
console.log(typeof error);
console.log(error.message);
console.log(error.stack);
console.log(error instanceof Error);
}
string
undefined
undefined
false
受け取った値はただの文字列なので、error.message も error.stack も undefined です。catch 側が「error.message を画面に出す」作りだと何も表示されず、どこで起きたのか(stack)も分かりません。MDN の throw のページでも、投げる値は「常に Error オブジェクトか、そのサブクラス(RangeError など)のインスタンスにすべき」とされています。ただし使っているライブラリが文字列を投げることもあるので、受け取る側では error instanceof Error ? error.message : String(error) のように確かめると安全です。
instanceof でエラーの種類ごとに分ける
Python の except ValueError: のように、JavaScript には catch でエラーの種類を指定する書き方がありません。catch は 1 つだけ書き、中で instanceof を使って分けます。
function readCount(text) {
try {
return JSON.parse(text).count.toFixed(1);
} catch (error) {
if (error instanceof SyntaxError) {
return "JSON が壊れています";
}
throw error;
}
}
console.log(readCount('{"count": 3}'));
console.log(readCount('{"count": 3'));
try {
readCount('{"total": 3}');
} catch (error) {
console.log("呼び出し元で:", String(error));
}
3.0
JSON が壊れています
呼び出し元で: TypeError: Cannot read properties of undefined (reading 'toFixed')
JSON が壊れている(SyntaxError)ことは予想していたので、ここで受け止めます。一方、count がない JSON で起きた TypeError は、予想していなかったエラーです。これを「JSON が壊れています」とひとまとめにすると、本当の原因が隠れてしまいます。そこで、想定した種類だけを処理し、それ以外は throw error; で投げ直して呼び出し元に任せます。これを「再スロー」と言います。
自作のエラークラスを作る(extends Error)
「入力の間違い」「通信の失敗」など、アプリ独自のエラーを区別したいときは、Error を元にした自分のエラークラスを作ります。extends Error は「Error の性質を受け継ぐ」という意味です。
class ValidationError extends Error {
constructor(message, field) {
super(message);
this.name = "ValidationError";
this.field = field;
}
}
function checkEmail(email) {
if (!email.includes("@")) {
throw new ValidationError("メールアドレスに @ がありません", "email");
}
return email;
}
try {
checkEmail("tanaka.example.com");
} catch (error) {
if (error instanceof ValidationError) {
console.log(error.name, error.field, error.message);
console.log(error instanceof Error);
console.log(String(error));
} else {
throw error;
}
}
ValidationError email メールアドレスに @ がありません
true
ValidationError: メールアドレスに @ がありません
super(message) で元の Error にメッセージを渡すと、message と stack が用意されます。this.field のように、どの入力欄が悪いかなどの情報も自由に足せます。this.name の設定を忘れると、name は元の Error のまま "Error" になります。class ValidationError extends Error {} だけで作ったエラーは、String(error) が「Error: 入力が正しくありません」となり、ログを見ても自作のエラーだと分かりません(instanceof ValidationError は true になります)。
cause で元のエラーをつなぐ(ES2022)
エラーを受け止めて、もっと分かりやすいメッセージのエラーを投げ直したいことがあります。そのとき元のエラーを捨てると、本当の原因が分からなくなります。そこで、new Error() の 2 番目の引数に { cause: 元のエラー } を渡して、原因をつないでおきます。
function loadSettings(text) {
try {
return JSON.parse(text);
} catch (error) {
throw new Error("設定を読み込めませんでした", { cause: error });
}
}
try {
loadSettings('{"theme": "dark",}');
} catch (error) {
console.log(error.message);
console.log(error.cause.name);
console.log(error.cause.message);
}
設定を読み込めませんでした
SyntaxError
Expected double-quoted property name in JSON at position 17 (line 1 column 18)
利用者や呼び出し元には「設定を読み込めませんでした」という分かりやすいメッセージを、調べる人には error.cause で「末尾のカンマのあとに項目名がない」という本当の原因を残せます。cause は ECMAScript 2022(ES2022)で入った機能で、MDN では 2021 年 9 月から主要なブラウザで使える(Baseline Widely available)とされています。Python の raise ... from と同じ考え方です(「Pythonの例外処理入門」参照)。
MDN の注意として、cause には Error 以外の値も入れられるので、受け取る側は「cause は必ず Error だ」と決めつけないようにします。
finally の使い道と、return の落とし穴
finally は、成功しても失敗しても必ず行いたい後片付けに使います。たとえば「読み込み中」の状態を元に戻す処理です。
let isLoading = false;
function loadData(text) {
isLoading = true;
try {
return JSON.parse(text);
} finally {
isLoading = false;
}
}
try {
loadData("{");
} catch (error) {
console.log("失敗:", error.name);
}
console.log("isLoading:", isLoading);
失敗: SyntaxError
isLoading: false
loadData には catch がない(try…finally の形)ので、エラーはそのまま呼び出し元に伝わります。それでも finally が実行されるので、isLoading は false に戻っています。try の最後で戻す書き方だと、エラーのときに「読み込み中」のまま固まります。
try の中で return した場合も、finally が実行されてから値が返ります。
finally の中で return すると、エラーが消える
気を付けたいのは、finally の中に return を書くことです。
function save() {
try {
throw new Error("保存に失敗しました");
} finally {
return "完了";
}
}
console.log(save());
完了
エラーが投げられたのに、関数は「完了」を返しました。finally の return が、投げられたエラーを上書きして消してしまうのです。保存に失敗したのに「完了」と表示される、という見つけにくい不具合になります。同じように、try で return "try の値"、finally で return "finally の値" と書くと、返るのは「finally の値」でした。
MDN でも、finally の中で return・throw・break・continue を使うと、それより前の処理の結果を上書きしてしまうため「一般によくない」とされています。finally には後片付けだけを書き、return は書かないと覚えておきましょう。
catch の引数は省略できる
エラーの中身を使わないときは、catch (error) の (error) を省いて catch だけ書けます(ES2019 からの書き方)。「JSON として読めるかどうか」だけを知りたい場合の例です。
function isValidJSON(text) {
try {
JSON.parse(text);
return true;
} catch {
return false;
}
}
console.log(isValidJSON('{"a": 1}'));
console.log(isValidJSON("{a: 1}"));
true
false
これは「失敗した」という事実そのものが答えになる場合の書き方です。次の節のように、失敗を黙って無視するために使うものではありません。
よくある間違い
1. 空の catch でエラーを握りつぶす
エラーが出なくなるからと、catch の中を空にするのはやめましょう。
function getUserName(json) {
try {
return JSON.parse(json).user.name;
} catch (error) {
// 何もしない
}
}
console.log(getUserName('{"user": {"name": "田中"}}'));
console.log(getUserName('{"user": null}'));
console.log(getUserName('{"user": {"name": "田中"}'));
田中
undefined
undefined
2 つ目(ユーザーがいない:TypeError)と 3 つ目(JSON の最後の } が足りない:SyntaxError)は原因がまったく違うのに、どちらも undefined になり、エラーが起きたことすら分かりません。後で「名前が表示されない」と言われても、手がかりがありません。
直し方は、想定できるケースは if で先に分け(data.user == null なら「名前なし」を返すなど)、本当のエラーは cause を付けて投げ直すことです。こうすると、呼び出し元で「ユーザー情報を読み込めません」と元の SyntaxError の両方が分かります。
どうしても処理を続けたい場合でも、少なくとも console.error(error) でエラーを記録しておきましょう。try で囲む範囲も、JSON.parse の行のようにエラーが起きうる行だけに絞ると、予想外のエラーまで受け止めてしまうことを防げます。
2. 非同期の処理のエラーが catch に来ない
try…catch が受け止めるのは、try の中を実行している間に起きたエラーだけです。setTimeout(指定した時間のあとに関数を実行する)で後から動く処理のエラーは、try を抜けた後に起きるので受け止められません。
try {
setTimeout(() => {
const user = null;
console.log(user.name);
}, 0);
} catch (error) {
console.log("catch:", error.message);
}
console.log("try を抜けた");
try を抜けた
Uncaught TypeError: Cannot read properties of null (reading 'name')
後から動く関数の中で try…catch を書く必要があります。一方、Promise を使う処理は、async 関数の中で await すれば、普通のエラーと同じように try…catch でまとめて受け止められます。
function fetchUser(id) {
return new Promise((resolve, reject) => {
setTimeout(() => reject(new Error(`ユーザー ${id} が見つかりません`)), 100);
});
}
async function showUser() {
try {
const user = await fetchUser(7);
console.log(user.name);
} catch (error) {
console.log("catch:", error.message);
} finally {
console.log("finally");
}
}
showUser();
catch: ユーザー 7 が見つかりません
finally
ただし await を付け忘れて const user = fetchUser(7); と書くと、try はすぐに最後まで進み、後で起きた失敗は catch に来ずに「Uncaught (in promise)」になりました。詳しくは「JavaScriptの非同期処理入門」を参照してください。
3. エラーの内容をそのまま利用者に見せる
error.message や error.stack を画面にそのまま表示するのは避けましょう。上で見たとおり、stack には関数名・ファイル名・行番号などのプログラムの内部の情報が入っていて、攻撃の手がかりを与えることがあります。
const message = document.createElement("p");
document.body.append(message);
function saveProfile() {
const settings = null;
return settings.theme;
}
try {
saveProfile();
} catch (error) {
console.error(error);
message.textContent = "保存できませんでした。時間をおいてもう一度お試しください。";
}
詳しい内容は開発者向けに console.error で記録し、画面には利用者向けの短い文を出します。画面に文字を出すときは innerHTML ではなく textContent を使います(エラーメッセージに入力された文字が含まれていても、HTML として解釈されないようにするため)。理由は「JavaScriptのDOM操作入門」と「XSS(クロスサイトスクリプティング)とは?」で説明しています。
よくある質問
受け止められなかったエラーを 1 か所で記録できますか?
ブラウザでは、window.addEventListener("error", …) で受け止められなかったエラーを、window.addEventListener("unhandledrejection", …) で受け止められなかった Promise の失敗を、まとめて受け取れます。Edge 155 で setTimeout の中で null.length を読んで試すと、event.message は「Uncaught TypeError: Cannot read properties of null (reading ‘length’)」、event.error は Error オブジェクトそのもの、event.reason は reject された値でした。
これはエラーを記録して知らせるための「最後の網」です。ここで受け取ってもエラーが起きた処理は途中で止まっているので、try…catch の代わりにはなりません。
まとめ
エラーが起きると処理はそこで止まります。起きうる行を try で囲み、catch で受け止め、後片付けは finally に書きます(finally に return は書かない)。自分でエラーを出すときは文字列ではなく throw new Error() を使い、種類は instanceof で分けて、想定外のものは投げ直します。原因は cause でつなぎ、空の catch で握りつぶさないこと、利用者には stack ではなく分かりやすい文を見せることを心がけましょう。
関連する記事・ツール
- JavaScriptの非同期処理入門|Promise・async/awaitの使い方
- JavaScriptのJSON.parseとstringify|エラーと消える値の注意点
- Pythonの例外処理入門|try・except・finally・raiseの使い方
- JavaScriptのDOM操作入門|textContentとinnerHTMLの違い
- URLエンコード・デコードツール
- JavaScriptのクラス構文入門|class・constructor・extendsとthisの落とし穴