Google Apps Script报错TypeError: Cannot read property 'range' of undefined求助

错误根源 #

报错TypeError: Cannot read property 'range' of undefined的核心原因是：你直接在脚本编辑器里手动运行了setTimestamp函数，但这个函数依赖Google Apps Script自动传入的事件对象e——只有当函数作为**安装型编辑触发器（onEdit）**被触发时（比如用户在表格里编辑了单元格），Google才会生成包含range属性的事件对象并传给函数。手动运行时e为undefined，读取e.range自然报错。

解决步骤 #

1. 创建安装型触发器 #

要让函数正常工作，必须给它绑定一个安装型的编辑触发器：

• 打开脚本编辑器，点击左侧菜单栏的「触发器」图标（时钟样式）
• 点击「添加触发器」
• 配置选项：
  • 选择要运行的函数：setTimestamp
  • 选择部署来源：「从云端硬盘」
  • 选择事件类型：「电子表格」→「编辑时」
• 点击「保存」，按照提示完成授权

之后当你在表格的第13列（DONE_COL）输入"Yes"时，函数会自动触发，在对应行的第16列（STAMP_COL）写入时间戳。

2. 调试时的临时方案 #

如果需要手动调试函数逻辑，可以临时添加一段模拟事件对象的代码，比如：

const DONE_COL = 13;
const STAMP_COL = 16;

function setTimestamp(e) {
  // 调试用：手动模拟事件对象，测试时保留，正式运行删除/注释
  e = {range: SpreadsheetApp.getActiveSpreadsheet().getSheetByName("你的工作表名").getRange("M2")};
  
  let timestamp = Utilities.formatDate(new Date(), "GMT+11", "dd/MM/yyyy HH:mm:ss");

  let range = e.range;
  let sheet = range.getSheet();
  let row = range.getRow();
  let col = range.getColumn();
  let value = range.getValue();

  if (col === DONE_COL && value === "Yes") {
    sheet.getRange(row, STAMP_COL).setValue(timestamp);
  } 
}

注意：调试完成后要删除或注释掉模拟事件对象的代码，否则会影响触发器的正常运行。

内容的提问来源于stack exchange，提问作者Tam