【GAS】getFontSizeとgetFontSizesの違いとは？セルのフォントサイズを正しく取得する方法

function fontSizeTrap() {
  const sheet = SpreadsheetApp.getActiveSheet();
  // A1は10pt, B1は14pt, C1は18ptだとする
  const range = sheet.getRange("A1:C1"); 
  
  // 範囲を指定しているにもかかわらず、A1の値である「10」しか返ってこない
  const fontSize = range.getFontSize(); 
  
  console.log(fontSize); // 結果は「10」
}

function correctWayToGetFontSizes() {
  const sheet = SpreadsheetApp.getActiveSheet();
  // A1は10pt, B1は14pt, C1は18pt
  const range = sheet.getRange("A1:C1");
  
  // API呼び出しは1回だけ！
  const fontSizes = range.getFontSizes(); 
  
  console.log(fontSizes); // 結果は [[10, 14, 18]]
  
  // 配列をループすれば、各セルの値にアクセスできる
  fontSizes[0].forEach(size => {
    console.log(`フォントサイズ: ${size}pt`);
  });
}

/**
 * データ範囲内で、フォントサイズが12ptより大きいセルを黄色でハイライトする
 */
function highlightLargeFonts() {
  const HIGHLIGHT_THRESHOLD = 12; // 強調表示するフォントサイズのしきい値
  
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getDataRange();
  
  // フォントサイズと背景色をそれぞれ一括取得
  const fontSizes = range.getFontSizes();
  const backgrounds = range.getBackgrounds();
  
  let isChanged = false;

  fontSizes.forEach((row, r) => {
    row.forEach((size, c) => {
      // しきい値より大きく、まだ色が設定されていないセルを対象
      if (size > HIGHLIGHT_THRESHOLD && backgrounds[r][c] !== '#ffff00') {
        backgrounds[r][c] = '#ffff00'; // 背景を黄色に変更
        isChanged = true;
      }
    });
  });

  // 変更があった場合のみ、一括で書き込む
  if (isChanged) {
    range.setBackgrounds(backgrounds);
  }
}