GAS(Google Apps Script)を動かしたら、「TypeError: Cannot read properties of null (reading 'getRange')」という英語のエラーで止まった。ネットで見つけたコードや、AI に作ってもらったコードを貼りつけたときに、とてもよく出るエラーです。
このエラーは「空っぽ(null)のものから getRange を呼ぼうとした」という意味です。多くの場合、その前の行でシートを取り出すのに失敗しています。この記事では、原因の見つけ方と、次から同じことで迷わないための書き方をまとめました。
■ まず、エラーの文の「reading '○○'」を見る
かっこの中の言葉が、呼ぼうとして失敗したものです。
・reading 'getRange'、'getLastRow'、'getDataRange' → ほとんどが「シートが見つからなかった」
・null ではなく「undefined (reading 'range')」と出る → onEdit などを、エディタの「実行」ボタンで動かした
・reading 'getSheetByName' → スプレッドシートそのものが開けていない
エラーの行の番号(「コード.gs:5」など)も出ているので、その 1 行前を見ると原因が見つかります。
■ 原因 1:シートの名前が、コードと少し違う(いちばん多い)
たとえばコードに getSheetByName('名簿') と書いてあるのに、シートのタブの名前が次のようになっていると、シートが見つからず null になります。
・「名簿 」のように、うしろに空白が入っている
・「シート1」と「シート1」のように、数字が全角と半角で違う
・「Sheet1」のまま、名前を変えていない
見た目では違いが分かりにくいので、コードに見つけてもらうのが早いです。次の関数を使うと、見つからなかったときに「似た名前のシートがあります」「今あるシートはこれです」と日本語で教えてくれます。
function getSheetOrStop(name) {
const ss = SpreadsheetApp.getActiveSpreadsheet();
if (!ss) {
throw new Error('スプレッドシートが開けません。シートの「拡張機能 → Apps Script」から作ったスクリプトか確かめてください。');
}
const sheet = ss.getSheetByName(name);
if (sheet) return sheet;
const norm = s => String(s).normalize('NFKC').replace(/\s/g, '');
const names = ss.getSheets().map(s => s.getName());
const near = names.filter(n => norm(n) === norm(name));
if (near.length > 0) {
throw new Error('シート「' + name + '」が見つかりません。似た名前のシート「' + near[0] + '」があります(空白や全角・半角の違い)。');
}
throw new Error('シート「' + name + '」が見つかりません。今あるシート:' + names.join('、'));
}
使い方は、今のコードの
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('名簿');
を
const sheet = getSheetOrStop('名簿');
に置きかえるだけです。違っていたら、シートのタブの名前か、コードの名前のどちらかにそろえてください。
■ 原因 2:onEdit などを、エディタの「実行」で動かした
onEdit(e) のような関数は、シートを編集したときに Google が e(どこが編集されたか)を渡してくれます。エディタの「実行」ボタンで動かすと e が空っぽなので、e.range を読んだところで止まります。この場合は、コードが悪いのではなく、試し方が違います。シートのセルを実際に書きかえて試してください。
エディタから押してしまっても止まらないように、最初に確かめておくと安心です。
function onEdit(e) {
if (!e) {
Logger.log('この関数はシートを編集したときに自動で動きます。エディタから実行しても動きません。');
return;
}
const range = e.range;
Logger.log(range.getSheet().getName() + ' の ' + range.getRow() + ' 行目が編集されました');
}
■ 原因 3:スプレッドシートに紐づいていないスクリプト
Google ドライブの「新規 → Apps Script」から作ったスクリプトは、どのスプレッドシートにも紐づいていません。この場合 SpreadsheetApp.getActiveSpreadsheet() が空っぽになります。スプレッドシートを開いて「拡張機能 → Apps Script」から作り直すか、SpreadsheetApp.openById('スプレッドシートのID') で開く書き方にします。
■ つまずきやすいところ
・シートの名前を変えると、コードの中の名前は自動では変わりません。あとで名前を変えるときは、コードの方も直してください
・コピーしたスプレッドシートでは、スクリプトも一緒にコピーされますが、トリガーはコピーされません。動かないときはトリガーも確かめてください
・試すときは、本番のシートのコピーで試すと安心です
■ 自分で直すのが大変なときは
「どの行が悪いのか分からない」「AI に作ってもらったコードが動かない」「直したら別のエラーが出た」といったときは、次の出品でお手伝いしています。
あわせて読みたい:
・GASで「Service invoked too many times」と出て止まるときの直し方
https://coconala.com/blogs/6357864/846754
この記事は、AI(Claude)の助けを借りて書いています。コードは、テスト用のデータで動きを確かめてから載せています。