GASでtry-catchを使う方法 | エラー処理

先生

GASのエラー処理、もう怖くない！try-catch構文をマスターして、安定したアプリ開発を🚀

GASにおけるエラー処理の重要性

Google Apps Script（GAS）でプログラムを作成する際、エラー処理は非常に重要です。エラー処理を適切に行うことで、予期せぬエラーが発生した場合でもプログラムが停止せず、安定した動作を保つことができます。

特に、外部APIとの連携やユーザーからの入力など、予期せぬ事態が発生しやすい処理を行う場合には、エラー処理が不可欠です。GASでエラー処理を行う方法として、try-catch構文があります。

try-catch構文の基本

try-catch構文は、エラーが発生する可能性のあるコードをtryブロックで囲み、エラーが発生した場合に実行するコードをcatchブロックで記述します。これにより、エラーが発生した場合でもプログラムが強制終了することなく、catchブロックで定義された処理を実行できます。

function myFunction() {
  try {
    // エラーが発生する可能性のあるコード
    Logger.log('tryブロック開始');
    throw new Error('意図的なエラー');
    Logger.log('tryブロック終了 (ここは実行されない)');
  } catch (e) {
    // エラーが発生した場合に実行するコード
    Logger.log('catchブロック開始');
    Logger.log('エラー内容: ' + e.message);
    Logger.log('catchブロック終了');
  }
  Logger.log('try-catchブロックの後の処理');
}

上記の例では、tryブロック内で意図的にエラーを発生させています。throw new Error('意図的なエラー')が実行されると、catchブロックに処理が移り、エラーメッセージがログに出力されます。tryブロック内でエラーが発生した場合、その後の処理は実行されず、catchブロックに直接ジャンプすることに注意してください。

具体的なtry-catchの利用例

GASでtry-catch構文を使用する具体的な例を見てみましょう。以下は、スプレッドシートからデータを読み込む際にエラーが発生した場合の処理を記述したコードです。

function readSpreadsheetData(spreadsheetId, sheetName) {
  try {
    var ss = SpreadsheetApp.openById(spreadsheetId);
    var sheet = ss.getSheetByName(sheetName);
    var data = sheet.getDataRange().getValues();
    return data;
  } catch (e) {
    Logger.log('スプレッドシートの読み込みエラー: ' + e.message);
    return null; // エラー発生時はnullを返す
  }
}

この例では、指定されたスプレッドシートやシートが存在しない場合、または権限がない場合にエラーが発生する可能性があります。try-catch構文を使用することで、エラーが発生した場合でもプログラムが停止せず、エラーメッセージをログに出力し、nullを返すことができます。

また、catchブロック内でエラーの種類に応じて異なる処理を行うことも可能です。例えば、権限エラーの場合はユーザーに権限の付与を促すメッセージを表示し、シートが存在しない場合はシートを作成する処理を行うなどが考えられます。

エラーオブジェクトの活用

catchブロックで受け取るエラーオブジェクトには、エラーに関する様々な情報が含まれています。主な情報としては、エラーメッセージ（e.message）、エラー名（e.name）、エラーが発生した行番号（e.lineNumber – これは常に利用できるとは限りません）などがあります。

これらの情報を活用することで、エラーの原因を特定しやすくなり、より適切なエラー処理を行うことができます。

function processData() {
  try {
    // ... 何らかの処理 ...
    if (someCondition) {
      throw new Error('条件が満たされませんでした');
    }
  } catch (e) {
    Logger.log('エラー名: ' + e.name);
    Logger.log('エラーメッセージ: ' + e.message);
    if (e.message === '条件が満たされませんでした') {
      // 特定のエラーに対する処理
      Logger.log('条件を満たすように処理を修正してください。');
    } else {
      // その他のエラーに対する処理
      Logger.log('予期せぬエラーが発生しました。');
    }
  }
}

上記の例では、エラーメッセージに基づいて特定のエラーに対する処理を分岐させています。このように、エラーオブジェクトを活用することで、より柔軟なエラー処理を実現できます。

finallyブロックの利用

try-catch構文には、finallyブロックを追加することもできます。finallyブロックは、tryブロックが正常に終了した場合でも、エラーが発生してcatchブロックが実行された場合でも、必ず実行される処理を記述します。

finallyブロックは、リソースの解放や後処理など、どのような場合でも実行する必要がある処理を記述するのに適しています。

function fileOperation() {
  var file = null;
  try {
    file = DriveApp.getFileById('your_file_id');
    // ファイルに対する何らかの操作
    Logger.log('ファイル操作成功');
  } catch (e) {
    Logger.log('ファイル操作エラー: ' + e.message);
  } finally {
    // ファイルのクローズ処理など（GASでは自動的にクローズされることが多いですが、明示的に行う場合もあります）
    Logger.log('finallyブロック実行');
  }
}

上記の例では、finallyブロックでファイルのクローズ処理を記述しています。GASではファイルのクローズ処理は自動的に行われることが多いですが、他の言語や環境では明示的にクローズ処理を行う必要がある場合があります。finallyブロックを使用することで、どのような場合でも確実にクローズ処理を実行できます。

参考リンク

まとめ

GASでtry-catch構文を使用することで、エラーが発生した場合でもプログラムが停止せず、安定した動作を保つことができます。エラーオブジェクトを活用することで、エラーの原因を特定しやすくなり、より適切なエラー処理を行うことができます。finallyブロックを使用することで、どのような場合でも実行する必要がある処理を確実に実行できます。これらのエラー処理の手法を理解し、GASでのプログラミングに役立ててください。