【GAS高速化】getFontStyles()でフォントスタイルを一括取得！API呼び出しを激減させる方法

// 【非推奨】APIを何度も呼び出す遅いコード
function slowStyleCheck(range) {
  for (let i = 1; i <= range.getNumRows(); i++) {
    for (let j = 1; j <= range.getNumColumns(); j++) {
      const style = range.getCell(i, j).getFontStyle();
      // ...処理...
    }
  }
}

// 【推奨】API呼び出しは1回のみ！高速なコード
function fastStyleCheck(range) {
  const styles = range.getFontStyles(); // API呼び出しはここだけ
  styles.forEach(row => {
    row.forEach(style => {
      // ...取得した配列を処理...
    });
  });
}

function logAllFontStyles() {
  const range = SpreadsheetApp.getActiveSheet().getRange("A1:B3");
  const styles = range.getFontStyles();
  
  styles.forEach((row, rowIndex) => {
    row.forEach((style, colIndex) => {
      const cellAddress = range.getCell(rowIndex + 1, colIndex + 1).getA1Notation();
      console.log(`セル ${cellAddress} のスタイル: ${style}`);
    });
  });
}

function generateStyleReport() {
  const range = SpreadsheetApp.getActiveSheet().getDataRange();
  const styles = range.getFontStyles();
  let italicCount = 0;
  const totalCells = range.getNumRows() * range.getNumColumns();

  // flat()で二次元配列を一次元化し、効率的に集計
  styles.flat().forEach(style => {
    if (style === 'italic') {
      italicCount++;
    }
  });

  const italicPercentage = (italicCount / totalCells * 100).toFixed(1);
  const message = `調査範囲: ${range.getA1Notation()}\n` +
                  `総セル数: ${totalCells}\n` +
                  `イタリックセルの数: ${italicCount}\n` +
                  `イタリックセルの割合: ${italicPercentage}%`;
  
  SpreadsheetApp.getUi().alert(message);
}

function normalizeAllItalicStyles() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getDataRange();
  
  // 変更対象のスタイル情報を一括で読み込む
  const styles = range.getFontStyles();
  
  let isChanged = false;

  // メモリ上の配列データを書き換える（ここでの処理は高速）
  const newStyles = styles.map(row => {
    return row.map(style => {
      if (style === 'italic') {
        isChanged = true;
        return 'normal'; // イタリックをnormalに置換
      }
      return style;
    });
  });
  
  // 変更があった場合のみ、シートに一括で書き込む
  if (isChanged) {
    range.setFontStyles(newStyles);
    SpreadsheetApp.getUi().alert('イタリック体を標準スタイルに修正しました。');
  } else {
    SpreadsheetApp.getUi().alert('イタリック体のセルは見つかりませんでした。');
  }
}