GASで自動化ツールを作って「これでバッチリ!」と思って実行したとき、画面に真っ赤なエラーメッセージが出て処理が途中で止まってしまった経験はありませんか?
例えば、スプレッドシートのシート名がいつの間にか変更されていたり、入力されているはずのセルが空欄だったりすると、プログラムは途中でパニックを起こして強制終了してしまいます。
冬の札幌で、いつも乗っているJRやバスが猛吹雪で運休してしまったとき、あらかじめ「地下鉄で移動する迂回ルート」を用意しておくと安心ですよね。プログラミングも全く同じです!
あらかじめ「もしエラーが起きたら、こうやって対処してね」という予備プランをコードに組み込んでおく仕組みが、今回学ぶ try...catch(トライ・キャッチ) です。
今回は、プログラムの信頼性を爆発的に高める try...catch の仕組みから基本構文、実務で使える具体的な書き方、初心者がハマりやすい落とし穴まで、どこよりも分かりやすく徹底解説していきます!
1. そもそも try…catch ってなに?
try...catch(トライ・キャッチ)を一言でいうと、「エラーが発生してもプログラムを強制終了させず、安全に迂回させるための保険(エラー処理)」 です。
「日常の予備プラン」でイメージしよう!
普段の生活でも、私たちは自然と「エラー処理」を行っています。
- 予備プランのない状態(try…catchなし):
- 「札幌で大人気のスープカレー屋さんに行ったら、なんと臨時休業だった!ショックでその日の予定がすべてキャンセルになり、家に帰った…」
- 予備プランがある状態(try…catchあり):
- try(やってみる): 「まずは第一希望のスープカレー屋さんに行ってみる」
- catch(エラー検知時の対応): 「もし臨時休業(エラー)だったら、近くにある別の美味しいルーカレーのお店に切り替えてランチを楽しむ!」
プログラミングにおける try...catch もまさにこれです。エラーが起きた瞬間にプログラム全体を破綻させるのではなく、「エラーを検知して、適切なメッセージを出したり別の処理を実行したりする」ことができます。
try…catch を使わないとどうなる?
例えば、複数の処理(①シートのデータ読み込み ➡ ②計算 ➡ ③チャットやメールへ通知)を順番に行うスクリプトがあったとします。
try...catch を書いていない場合、①の段階でエラーが発生すると、プログラムはその場で即座に強制終了します。その結果、②や③の処理は一切実行されず、ユーザーは何が起きたのか分からないまま赤文字のエラー画面だけを見るハメになります。
しかし try...catch を書いておけば、①でエラーが起きてもそれを優しく検知し、「シートが見つかりませんでした」と画面に分かりやすく表示(第26回『Ui.alert()』 を参照)した上で、安全に処理を終了させることができるのです。
2. 基本文法と構造をマスターしよう
try...catch の基本的な書き方はとてもシンプルです。3つのブロックで構成されています。
try {
// ① エラーが起きるかもしれない処理(通常ルート)
} catch (e) {
// ② エラーが発生したときだけ実行される処理(迂回ルート)
} finally {
// ③ エラーの有無にかかわらず「最後に絶対実行される処理」(省略可能)
}
それぞれの役割を分解!
tryブロック- カッコ
{ }の中に、「実行したいメインの処理」を書きます。 - ここでエラーが発生しなかった場合は、そのまま
tryブロックを抜けて通常通り処理が終了します(catchの中は無視されます)。
- カッコ
catch (e)ブロックtryブロックの中で何かエラーが発生した「その瞬間」、即座にこのカッコの中に処理が飛びます。- カッコ内の
e(エラーオブジェクト) には、「どんなエラーが発生したか」の情報が自動的に入ります。
finallyブロック(オプション)- エラーが起きても起きなくても、「最後に必ず1回実行したい処理」 がある場合に書きます(不要な場合は省略できます)。
3. STEP1:エラーが起きるシチュエーションを体験してみよう
まずは、あえてエラーが発生するコードを書いて、try...catch がない場合の動きを確認してみましょう。
1. スプレッドシートの準備
- 練習用のスプレッドシートを開き、シート名を 「札幌オフィス」 にしておきます。
- 上部メニュー「拡張機能」 > 「Apps Script」を開きます。
2. あえてエラーになるコードを実行してみる
存在しない「小樽オフィス」というシートを取得しようとするコードです。
function testErrorWithoutTryCatch() {
var ss = SpreadsheetApp.getActiveSpreadsheet();
// 存在しないシートを取得しようとする(sheetの中身は null になる)
var sheet = ss.getSheetByName("小樽オフィス");
// nullに対して getRange() を呼び出そうとするため、ここでエラー発生!
var value = sheet.getRange("A1").getValue();
Logger.log("A1セルの値: " + value);
}
これを実行すると、エディタ画面に赤文字で次のような厳しいエラーが出力され、処理が強制ストップしてしまいます。
TypeError: Cannot read properties of null (reading 'getRange')
これだと、GASに慣れていない非エンジニアの同僚が使ったとき、「なんか壊れた!?」と不安になってしまいますよね。
4. STEP2:【実践】try…catch で安全にエラーをキャッチしよう!
それでは、先ほどのエラーが出るコードを try...catch で包み、エラーが起きても安全に対処できるように改善してみましょう!
1. コードを入力する
以下のコードをコピーしてエディタに貼り付けてみてください。
function testErrorWithTryCatch() {
try {
// 1. 開いているスプレッドシートを取得(第2回参照)
var ss = SpreadsheetApp.getActiveSpreadsheet();
// 2. シートを取得(存在しないシート名を指定)
var sheet = ss.getSheetByName("小樽オフィス");
// 3. データを取り出す(シートが存在しないためエラーが発生!)
var value = sheet.getRange("A1").getValue();
// エラーが起きると、この下の行は実行されずに catch へ飛びます
Logger.log("取得した値: " + value);
} catch (e) {
// 4. エラーが発生したときに実行される処理
Logger.log("【エラー検知】処理中に問題が発生しました。");
Logger.log("エラーの詳細: " + e.message);
// 5. ユーザーに親切なアラートダイアログを表示する(第26回参照)
SpreadsheetApp.getUi().alert(
"エラーのお知らせ",
"「小樽オフィス」シートが見つかりませんでした。\nシート名が正しいか確認してください。",
SpreadsheetApp.getUi().ButtonSet.OK
);
}
}
2. 実行結果を確認する
このコードを実行してみましょう!
- 赤文字の致命的なエラーで停止するのではなく、ログ画面に自作したメッセージが表示されます。Plaintext
情報 【エラー検知】処理中に問題が発生しました。 情報 エラーの詳細: Cannot read properties of null (reading 'getRange') - スプレッドシートの画面上に「「小樽オフィス」シートが見つかりませんでした。シート名を確認してください。」という親切なポップアップ(アラート)が表示されます。
プログラムが途中で壊れて強制終了するのではなく、「何が原因で失敗したのか」をユーザーに分かりやすく伝えて、安全に処理を終えることができました!
5. STEP3:finally ブロックで「後始末」を確実に実行しよう
try...catch には、finally(ファイナリー)というブロックを追加することができます。
finally の中に書いたコードは、「tryで無事に成功した場合」でも「catchでエラーを捕まえた場合」でも、一番最後に必ず実行されます。
実務での活用例:「処理の実行ログ」を必ず記録する
例えば、「処理の開始時間」と「終了時間」をログや別シートに記録したい場合、途中でエラーが起きても「終了ログ」だけは絶対に記録しておきたいですよね。
function processWithFinally() {
Logger.log("--- 処理を開始します ---");
try {
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getActiveSheet();
// 何らかの処理...
var data = sheet.getRange("A1").getValue();
Logger.log("データを取得しました: " + data);
} catch (e) {
Logger.log("エラーをキャッチしました: " + e.message);
} finally {
// エラーの有無にかかわらず、最後に必ず実行される!
Logger.log("--- すべての処理ステップが終了しました(後始末完了) ---");
}
}
途中でエラーが起きても起きなくても、最後の finally の中のログは確実に記録されます。ファイルのクローズ処理や、一時的なフラグの解除など、「後始末(クリーンアップ)」 を行う際に非常に役立ちます。
6. 実務でよく使う try…catch の応用シーン3選
実務の自動化ツール開発において、try...catch が特に威力を発揮する3つのシチュエーションをご紹介します。
1. 外部連携(API通信やメール送信)の失敗対策
次回以降のフェーズで学ぶ GmailApp.sendEmail()(第31回)や外部WEB API連携(第72回)など、インターネットを経由する処理は「通信エラー」や「相手サーバーのダウン」によってエラーが起きやすいポイントです。
try {
// Gmailでメールを送信する処理
GmailApp.sendEmail("example@example.com", "出張レポート", "本文です");
} catch (e) {
// 送信失敗時にログを残し、予備の管理者アドレスへ通知する
Logger.log("メール送信に失敗しました: " + e.message);
}
2. 大量データのループ処理(for文)で1件のエラーで全体を止めない
100件ある出張経費データ(第7回『appendRow』参照)を順番に処理する際、たった1件データが不正だからといって全自動処理が途中で止まってしまうのは勿体ないですよね。
for (var i = 0; i < dataList.length; i++) {
try {
// 1件ずつ処理を行う
processRowData(dataList[i]);
} catch (e) {
// エラーが起きた行だけスキップしてログに記録し、次の行の処理を継続する!
Logger.log((i + 1) + "件目のデータ処理でエラーが発生しました: " + e.message);
}
}
ループの中に try...catch を入れることで、「エラーが起きたデータだけをスキップして、残りの99件の処理を最後まで完走させる」というタフなプログラムが作れます!
3. 数値計算時の「空欄」や「文字列混入」チェック
第5回『getValue()』 でセルのデータを取り出す際、ユーザーが数字ではなく文字を入力していたり、空欄だったりして計算エラー(NaNなど)になるのを未然に防ぐことができます。
7. 初心者が絶対につまずく「3大トラップ」と解決策
try...catch は非常に強力ですが、正しく理解していないと予期せぬトラブルにつながります。初心者がハマりやすい3つの注意点を押さえておきましょう。
トラップ1:文法エラー(SyntaxError)は Catch できない!
try...catch がキャッチできるのは、プログラムを実行している最中に起きるエラー(実行時エラー / 例外)だけです。
カッコの閉じ忘れ ; の抜け、スペルミスなどの 「文法エラー(SyntaxError)」 は、プログラムを実行する前の段階でエラーと判定されるため、try...catch では防げません。
- ✕ 防げない例(構文エラー):JavaScript
try { var ss = SpreadsheetApp.getActiveSpreadsheet( // カッコが閉じられていない! } catch (e) { ... }
文法チェックはエディタの赤波線などを確認してしっかり直しましょう!
トラップ2:エラーを「無言で握り潰す(サイレントエラー)」
一番やってはいけないのが、catch の中を空っぽにしてしまうことです。
// ✕ やってはいけないNGコード!
try {
var value = sheet.getRange("A1").getValue();
} catch (e) {
// 中身が空っぽ!エラーが起きても人間が気づけない!
}
これをしてしまうと、エラーが起きても何のログも残らず、画面にも何も表示されないため、「なぜか動かないけれど原因が全く分からない」という最悪のバグを引き起こします。
catch の中には、最低限 Logger.log(e.message) や e.stack を書いて、何が起きたかを記録する 癖をつけましょう!
トラップ3:e と e.message の違いを知っておく
catch (e) の e はエラー情報が詰まった「オブジェクト(箱)」です。
Logger.log(e)➡ エラーオブジェクト全体を出力Logger.log(e.message)➡ 「Cannot read properties of null…」といった エラー文面(テキスト)のみ をすっきり出力Logger.log(e.stack)➡ コードの何行目でエラーが起きたか の詳細履歴を出力
ユーザーへの画面通知には e.message を使い、開発時のデバッグには e.stack を使うと非常にスムーズです!
8. 今回のまとめ&次回予告
今回は、プログラムの信頼性を向上させる try...catch(エラー処理) について学びました。
今日の重要ポイント
tryブロックにメインの処理を書き、catchブロックにエラー発生時の退避処理を書くtry...catchを使うと、プログラムの強制終了を防ぎ、ユーザーに親切な通知ができるfinallyブロックを使うと、エラーの有無に関わらず最後の「後始末処理」を確実に実行できるcatchの中でエラーを無言で放置(握り潰し)せず、必ずLogger.log(e.message)でログを残す
これで、フェーズ3「自動化・UI拡張・エラー処理(第21回〜第30回)」がすべて完了しました!お疲れ様でした!
スプレッドシートの操作からカスタムメニューの作成(第25回)、ポップアップ表示(第26回)、そして今回のエラー処理までマスターしたあなたは、もう立派なGASマーケター・エンジニアの仲間入りです。
次回予告:いよいよ「Gmail連携・メール自動配信」フェーズへ!
次回(第31回)からは、待望の フェーズ4「Gmail連携・メール自動配信(第31回〜第40回)」 に突入します!
GASからGmailを自由自在に操り、スプレッドシートのデータを美しいデザインメールにして自動送信するテクニックを解説します。業務効率化が一気に加速しますので、ぜひお楽しみに!
