リファクタリング

GAS getFontColors()解説 (旧メソッド) - なぜ新getFontColorObjects()へ移行すべきか

GAS getFontColors()解説 (旧メソッド) - なぜ新getFontColorObjects()へ移行すべきか

 [GAS]
 2025-11-28

Google Apps Script (GAS) でスプレッドシートの文字色を一括取得する際、getFontColors() というメソッドが存在します。しかし、これは現在 旧式 (Legacy) となっており、より高機能な getFontColorObjects() の使用が強く推奨されています。

この記事では、getFontColors() の基本的な仕様を解説すると共に、なぜ新しいメソッドへ移行すべきなのか、その決定的な違いと具体的な移行方法を解説します。

Google Apps Script 始め方 スプレッドシート 活用例
Google Apps Script 始め方 スプレッドシート 活用例 を各ショップで検索

getFontColors() の基本仕様

getFontColors() は、指定した範囲の各セルの文字色を、#ff0000 のような16進数カラーコードの文字列の二次元配列 (String[][]) として取得します。