JavaScript
PR

JavaScriptのエラー処理入門|try・catchとErrorの使い方

JavaScriptのエラー処理入門|try・catchとErrorの使い方
hr
記事内に商品プロモーションを含む場合があります

JavaScript のプログラムは、途中でエラーが起きるとその場で止まります。画面のボタンが急に反応しなくなる原因の多くは、どこかで起きたエラーを誰も受け止めていないことです。エラーを受け止めて、利用者に分かる形で知らせたり、処理を続けたりする仕組みが try・catch・finally と Error オブジェクトです。

この記事では、処理の流れ、エラーの種類とメッセージ、throw、自作のエラークラス、cause、finally の落とし穴を、実際の出力で確かめながら説明します。出力は Windows 11 の Microsoft Edge 155 で実行したものです。

この記事のコードの試し方

コードはブラウザの開発者ツールのコンソールで試せます(インストールは不要です)。

  1. Edge または Chrome で、どのページでもよいので開いた状態で F12 キーを押します。
  2. 開いた画面の上部にある「Console(コンソール)」タブを選びます。
  3. 記事のコードをコピーして貼り付け、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 の右)。

左はエラーが起きたときの流れ。tryの中で1. 開始のあと、user.nameでエラーが起きると、残りの行は飛ばされて矢印でcatchに移り、続いてfinally、tryの後の処理へ進む。右はエラーが起きないときの流れ。tryの中を最後まで実行し、catchは実行されずにfinallyへ進み、tryの後の処理へ続く。
図 1:try の中でエラーが起きると残りを飛ばして catch へ。finally はどちらでも実行される

よく出るエラーの種類とメッセージ

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)
URIErrorURL のエンコードの形が正しくない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 ではなく分かりやすい文を見せることを心がけましょう。

関連する記事・ツール

ABOUT ME
hr
hr
エンジニアとして働いている hr です。仕事や資格勉強で「こんなツールがあれば」と感じたものを、無料Webツールと解説記事にして発信しています。
記事URLをコピーしました