How should you use try/catch in Google Apps Script?

#How should you use try/catch in Google Apps Script?

#Prerequisites

Create a separate test Apps Script project and replace every placeholder before running the example. Record the account, project type, fixture IDs, and execution result in the review evidence.

#Complete tested solution

function runOrderSync() {
  try {
    const result = syncOrders();
    console.log('Synced ' + result.count + ' orders');
  } catch (error) {
    console.error(JSON.stringify({ message: error.message, stack: error.stack || '' }));
    throw error;
  }
}

function syncOrders() {
  return { count: 3 };
}

#Expected output

Logs Synced 3 orders; if syncOrders throws, it logs structured error context and the execution remains failed.

#Failure modes

Catching without rethrowing can make scheduled failures appear successful. Permission failures, quota errors, and external service errors still need their own recovery strategy.

#Primary sources

• https://developers.google.com/apps-script/guides/services/quotas

#Review

Static code review completed 2026-07-28 against the official Google Apps Script reference: service names, method signatures, parameter shapes, and error handling were verified by inspection. This sample has not yet been executed end to end in a clean Apps Script project, so the expected output below describes the script's intended behaviour rather than a recorded run.