GASで使えるモダンJavaScript構文8選
｜V8ランタイム

{
  "timeZone": "Asia/Tokyo",
  "dependencies": {},
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8"
}

// runtimeVersion が "V8" ならモダン構文が使える。
// "DEPRECATED_ES5" と書かれていれば古いRhinoエンジンで動いている。
// 「プロジェクトの設定 > Chrome V8 ランタイムを有効にする」で切り替えられる。

// 01. var をやめて let / const にする

function oldStyle() {
  for (var i = 0; i < 3; i++) {
    // var は関数全体が有効範囲。ループを抜けても i が生き残る
  }
  console.log(i);  // 3 が出てしまう
}

function newStyle() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("売上");
  const values = sheet.getDataRange().getValues();

  for (let i = 1; i < values.length; i++) {
    // let はブロックの中だけ。i はこのループの外では存在しない
    const row = values[i];
    console.log(row[0]);
  }
}

// 使い分けは単純。
// 再代入しないものは const、ループのカウンタなど再代入するものだけ let。
// const は「中身が変わらない」ではなく「その名前に別の値を入れ直さない」宣言。
// const rows = [...] の中身を push で増やすのは問題ない。

// 02. テンプレートリテラルで文字列を組み立てる

const name = "田中";
const count = 12;

// 旧: + でつなぐ。空白や全角の位置を間違えやすい
const oldText = name + "様\n本日の件数は" + count + "件です。";

// 新: バッククォートで囲み ${} に式を書く。改行もそのまま書ける
const newText = `${name}様
本日の件数は${count}件です。`;

// メール本文のような複数行の文字列と特に相性が良い
function sendDailyReport() {
  const today = Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyy/MM/dd");
  const total = 128000;

  MailApp.sendEmail({
    to: "team@example.com",
    subject: `【日次レポート】${today}`,
    body: `${today} の集計結果です。

  売上合計: ${total.toLocaleString()}円
  処理件数: ${count}件

  詳細はスプレッドシートをご確認ください。`,
  });
}

// 03. アロー関数・分割代入・スプレッド構文

const sheet = SpreadsheetApp.getActive().getSheetByName("問い合わせ");
const [header, ...rows] = sheet.getDataRange().getValues();
// 1行目を header に、残りすべてを rows に分ける（スプレッド構文）

// アロー関数: function(row) { return ...; } の短縮形
const names = rows.map((row) => row[0]);

// 配列の分割代入。row[0] や row[2] という書き方をやめられる
const summaries = rows.map(([name, email, body]) => {
  return `${name}(${email}): ${body.slice(0, 20)}`;
});

// オブジェクトの分割代入。設定値の取り出しに便利
function callApi(options) {
  const { model = "claude-opus-5", maxTokens = 512, prompt } = options;
  // model と maxTokens は省略時のデフォルト値付きで受け取れる
  console.log(`${model} / ${maxTokens} / ${prompt}`);
}

// スプレッド構文はオブジェクトの上書きにも使える
const baseConfig = { model: "claude-opus-5", max_tokens: 512 };
const longConfig = { ...baseConfig, max_tokens: 4096 };  // 一部だけ差し替え

// 注意: 分割代入の変数名は「列の順番」に依存する。
// 列の並びが変わる可能性があるシートでは、ヘッダー行から
// 列名でオブジェクト化してから扱うほうが安全。

// 04. map / filter / reduce でシートのデータを処理する

function summarizeSales() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("売上");
  const [header, ...rows] = sheet.getDataRange().getValues();

  // ヘッダー行をキーにしたオブジェクト配列へ変換
  const records = rows
    .filter((row) => row[0] !== "")                       // 空行を除く
    .map((row) => Object.fromEntries(header.map((key, i) => [key, row[i]])));

  // 条件で絞る
  const completed = records.filter((r) => r["ステータス"] === "完了");

  // 合計する（reduce の第2引数 0 が初期値）
  const total = completed.reduce((sum, r) => sum + Number(r["金額"] || 0), 0);

  // 担当者ごとに集計する
  const byOwner = completed.reduce((acc, r) => {
    const owner = r["担当者"];
    acc[owner] = (acc[owner] || 0) + Number(r["金額"] || 0);
    return acc;
  }, {});

  // 1件だけ探す。見つからなければ undefined
  const top = completed.find((r) => Number(r["金額"]) > 1000000);

  console.log(`完了 ${completed.length}件 / 合計 ${total.toLocaleString()}円`);
  console.log(JSON.stringify(byOwner));
  console.log(top ? top["案件名"] : "100万円超の案件なし");
}

// ポイント: これらはすべてメモリ上の配列に対する処理。
// ループの中で getValue() を呼ぶ書き方より圧倒的に速い。
// シートへのアクセスは「最初に一括read、最後に一括write」が基本。

// 05. class で共通処理をまとめる

class ClaudeClient {
  constructor(apiKey, model = "claude-opus-5") {
    this.apiKey = apiKey;
    this.model = model;
    this.endpoint = "https://api.anthropic.com/v1/messages";
  }

  // 静的メソッド: インスタンスを作らずに呼べる
  static fromProperties() {
    const key = PropertiesService.getScriptProperties().getProperty("ANTHROPIC_API_KEY");
    if (!key) throw new Error("ANTHROPIC_API_KEY が未設定です");
    return new ClaudeClient(key);
  }

  ask(prompt, { system = "", maxTokens = 512 } = {}) {
    const res = UrlFetchApp.fetch(this.endpoint, {
      method: "post",
      contentType: "application/json",
      headers: { "x-api-key": this.apiKey, "anthropic-version": "2023-06-01" },
      payload: JSON.stringify({
        model: this.model,
        max_tokens: maxTokens,
        ...(system ? { system } : {}),   // system が空なら送らない
        messages: [{ role: "user", content: prompt }],
      }),
      muteHttpExceptions: true,
    });

    if (res.getResponseCode() !== 200) {
      throw new Error(`Claude APIエラー: ${res.getResponseCode()} ${res.getContentText()}`);
    }
    const json = JSON.parse(res.getContentText());
    return json.content?.[0]?.text?.trim() ?? "";
  }
}

// 使う側はこれだけ
function classifyRow() {
  const claude = ClaudeClient.fromProperties();
  const answer = claude.ask("この問い合わせを1語で分類してください。\n配送が遅れています", {
    system: "見積 / 不具合 / その他 のいずれか1語だけを返してください。",
    maxTokens: 32,
  });
  console.log(answer);
}

// 注意: class は「複数の関数が同じ設定値を共有する」ときに効く。
// 1つしか関数が無いなら、素直に function のままで十分。

// 06. オプショナルチェーン（?.）とNull合体演算子（??）

const json = JSON.parse(res.getContentText());

// 旧: 途中が無いと「Cannot read property of undefined」で落ちる
const oldText = json.content[0].text;

// 旧の対策: 毎回チェックが必要で読みづらい
const safeOld =
  json && json.content && json.content[0] && json.content[0].text
    ? json.content[0].text
    : "";

// 新: ?. は途中が null / undefined ならそこで undefined を返して止まる
// ?? は左が null / undefined のときだけ右の値を使う
const text = json.content?.[0]?.text ?? "";

// || との違いに注意。
const count1 = 0 || 10;   // 10（0 は偽とみなされる）
const count2 = 0 ?? 10;   // 0（null/undefined のときだけ右を使う）
// 「0 や空文字も正しい値」として扱いたい場面では ?? が正しい。

// シートの値の取り扱いでも役立つ
function readConfig() {
  const props = PropertiesService.getScriptProperties();
  const raw = props.getProperty("CONFIG");
  const config = raw ? JSON.parse(raw) : {};

  const retry = config.api?.retry ?? 3;          // 未設定なら 3
  const label = config.gmail?.label ?? "処理済み";
  console.log(`retry=${retry} / label=${label}`);
}

// 07. V8でも使えない・気をつける書き方

// × Rhino時代の for each。V8では構文エラーになる
// for each (var value in values) { ... }

// ○ for...of に書き換える
function loopValues(values) {
  for (const value of values) {
    console.log(value);
  }
  // index も欲しいときは entries()
  for (const [i, value] of values.entries()) {
    console.log(`${i}: ${value}`);
  }
}

// △ async / await は「書けるが意味がない」
async function notReallyAsync() {
  // UrlFetchApp は同期的に結果を返す。await しても速くならない
  const res = UrlFetchApp.fetch("https://example.com");
  return res.getContentText();
}

// ○ 複数リクエストを並列にしたいなら fetchAll を使う
function parallelFetch(urls) {
  const requests = urls.map((url) => ({ url, muteHttpExceptions: true }));
  const responses = UrlFetchApp.fetchAll(requests);
  return responses.map((r) => r.getResponseCode());
}

// × setTimeout / setInterval は存在しない（ブラウザやNode.jsの機能）
// ○ 待つなら Utilities.sleep(1000)、定期実行はトリガーで行う