解决GAS中onEdit触发TypeError: Cannot read properties of undefined (reading 'range')问题

问题背景 #

现有Google表格需求：

• 第16、17列单元格初始为空，允许公开编辑；
• 第5、6列单元格初始值为"no"（隐藏状态），与前两列关联；
• 当第5/6列对应行值为"no"，且第16/17列对应行被修改为非空时，将该单元格设置为仅指定邮箱（如mymail@gmail.com）可编辑，禁止公开修改。

编写的onEdit触发器脚本如下：

function onEdit(event) {
  var range = event.range;
  var sheet = range.getSheet();
  var idCol = range.getColumn();
  var idRow = range.getRow();
  var newValue = range.getValue();

  if (sheet.getName() == 'Sheet1' ) {
    if (idCol == 16 || idCol == 17) { 
      var adjacentCellCol = idCol + 5; // 6 if idCol is 16, 7 if idCol is 17
      var adjacentCell = sheet.getRange(idRow, adjacentCellCol);
      if (newValue !== "" && adjacentCell.getValue() == "нет") {
        var protection = sheet.getRange(idRow, idCol).protect();
        protection.removeEditor('anyone');
        protection.addEditor("mymail@gmail.com");
        protection.setDomainEdit(false);
        protection.setWarningOnly(false);
        Logger.log('Cell protected: ' + e.range.getA1Notation());
      }
    }

    if (idCol == 16 || idCol == 17) { 
      if (newValue >= 25) {
        var vartoday = new Date();
        sheet.getRange(idRow, idCol-6).setValue(vartoday);
      } else if (newValue === "" || newValue < 25) {
        sheet.getRange(idRow, idCol-6).setValue(idCol == 16 ? "not 1 module" : "not 2 module");
      }
    }
  }
}

触发时出现错误：TypeError: Cannot read properties of undefined (reading 'range')，且单元格仍可被公开修改。脚本编辑器直接运行报错，实际表格编辑时脚本也未正常生效。

错误原因分析 #

• 变量名拼写错误：在Logger.log语句里用了未定义的e，但函数参数是event，应该改为event.range.getA1Notation()。这个错误会直接抛出异常，中断脚本执行，导致后续的单元格保护逻辑根本跑不起来。
• 关联列计算完全错误：需求里第16列对应第5列、第17列对应第6列，但代码里adjacentCellCol = idCol +5算出来的是21、22列，完全偏离目标列，正确计算应该是idCol -11（16-11=5，17-11=6）。
• 字符串匹配不对应：代码里判断的是俄语的"нет"，但需求里说第5/6列初始值是英文"no"，如果表格里实际值是英文，这个判断条件永远不成立，保护逻辑不会触发。
• 脚本编辑器直接运行报错是正常现象：手动运行onEdit时没有传入event参数，必然会报range未定义的错，但实际表格编辑时的失效是前面的代码逻辑错误导致的。

修复后的脚本 #

function onEdit(event) {
  var range = event.range;
  var sheet = range.getSheet();
  var idCol = range.getColumn();
  var idRow = range.getRow();
  var newValue = range.getValue();

  // 只处理Sheet1的编辑
  if (sheet.getName() !== 'Sheet1') return;

  // 仅处理第16、17列的编辑
  if (idCol !== 16 && idCol !== 17) return;

  // 计算对应关联列：16列对应5列，17列对应6列
  var targetCol = idCol - 11;
  var targetCell = sheet.getRange(idRow, targetCol);
  var targetValue = targetCell.getValue();

  // 处理单元格保护逻辑：关联列值为"no"且当前单元格非空时设置保护
  if (newValue !== "" && targetValue === "no") {
    var protection = range.protect();
    // 移除所有公共编辑权限
    protection.removeEditors(protection.getEditors());
    protection.removeEditor('anyone');
    // 添加指定编辑者
    protection.addEditor("mymail@gmail.com");
    protection.setDomainEdit(false);
    protection.setWarningOnly(false);
    Logger.log('Cell protected: ' + range.getA1Notation());
  } else if (newValue === "") {
    // 可选：当单元格清空时移除保护
    var protections = sheet.getProtections(SpreadsheetApp.ProtectionType.RANGE);
    for (var i = 0; i < protections.length; i++) {
      var p = protections[i];
      if (p.getRange().getA1Notation() === range.getA1Notation()) {
        p.remove();
        Logger.log('Cell protection removed: ' + range.getA1Notation());
        break;
      }
    }
  }

  // 处理日期/状态设置逻辑
  if (newValue >= 25) {
    sheet.getRange(idRow, idCol - 6).setValue(new Date());
  } else if (newValue === "" || newValue < 25) {
    sheet.getRange(idRow, idCol - 6).setValue(idCol === 16 ? "not 1 module" : "not 2 module");
  }
}

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