Google Sheets中ui.prompt点击外部超时无返回，如何捕获异常？

一、捕获弹窗外部点击的状态 #

ui.prompt被点击外部时的中断属于Google Apps Script运行环境的强制终止，普通try-catch无法捕获——这种中断不会抛出JavaScript可捕获的异常。可通过以下两种方案处理：

1. 时间戳+可安装触发器检测中断 #

思路是在弹窗弹出前记录时间，同时设置短延迟触发器（比如3-5秒）；如果弹窗正常完成，主动取消触发器；如果触发器触发，说明脚本已被中断（用户点击了弹窗外部）。

代码示例：

function showPrompt() {
  // 记录弹窗启动时间
  PropertiesService.getUserProperties().setProperty('PROMPT_START_TIME', Date.now());
  
  // 创建5秒后触发的中断检测触发器
  const trigger = ScriptApp.newTrigger('handlePromptInterrupt')
    .timeBased()
    .after(5000)
    .create();
  PropertiesService.getUserProperties().setProperty('PROMPT_TRIGGER_ID', trigger.getUniqueId());

  const ui = SpreadsheetApp.getUi();
  try {
    const result = ui.prompt(
      'Instruction:',
      'Another instruction',
      ui.ButtonSet.OK_CANCEL
    );
    
    // 弹窗正常完成，清理触发器
    const triggerId = PropertiesService.getUserProperties().getProperty('PROMPT_TRIGGER_ID');
    ScriptApp.getProjectTriggers().forEach(t => {
      if (t.getUniqueId() === triggerId) ScriptApp.deleteTrigger(t);
    });
    PropertiesService.getUserProperties().deleteProperty('PROMPT_TRIGGER_ID');
    
    // 处理用户正常操作
    if (result.getSelectedButton() === ui.Button.OK) {
      Logger.log('用户点击OK，输入值：' + result.getResponseText());
    } else {
      Logger.log('用户点击Cancel');
    }
  } catch (e) {
    Logger.log('弹窗执行异常：' + e.message);
  }
}

function handlePromptInterrupt() {
  // 判定为用户点击弹窗外部导致中断
  Logger.log('用户点击弹窗外部，脚本中断');
  
  // 清理临时存储和触发器
  const triggerId = PropertiesService.getUserProperties().getProperty('PROMPT_TRIGGER_ID');
  if (triggerId) {
    ScriptApp.getProjectTriggers().forEach(t => {
      if (t.getUniqueId() === triggerId) ScriptApp.deleteTrigger(t);
    });
    PropertiesService.getUserProperties().deleteProperty('PROMPT_TRIGGER_ID');
  }
  PropertiesService.getUserProperties().deleteProperty('PROMPT_START_TIME');
}

2. 替代方案：用单元格输入替代弹窗 #

如果触发器方案过于复杂，可以放弃弹窗，改用指定单元格让用户输入内容，通过触发器监听单元格变化：

function onEdit(e) {
  // 指定用户输入的单元格，比如A1
  const inputRange = SpreadsheetApp.getActiveSpreadsheet().getRange('A1');
  if (e.range.getA1Notation() === inputRange.getA1Notation()) {
    const userInput = e.value;
    Logger.log('用户输入内容：' + userInput);
    // 这里添加输入后的处理逻辑
    // 可选：清空单元格，方便下次输入
    inputRange.clearContent();
  }
}

这种方式完全规避了弹窗的中断问题，适合对交互要求不高的场景。

二、获取用户唯一标识的替代方案 #

onEdit简单触发器无法获取用户邮箱，可通过以下方式解决：

1. 改用可安装触发器 #

将简单的onEdit触发器改为可安装的onEdit/onChange触发器，可安装触发器拥有更高权限，能正常调用Session.getActiveUser().getEmail()获取用户邮箱。

设置步骤：

• 打开脚本编辑器，点击左侧「触发器」图标
• 点击「添加触发器」，选择对应函数，事件类型选「从电子表格 - 编辑时」，完成授权即可

代码示例：

function installableOnEdit(e) {
  const userEmail = Session.getActiveUser().getEmail();
  Logger.log('当前编辑用户邮箱：' + userEmail);
  // 这里添加投票记录逻辑
}

2. 手动收集用户标识 #

如果无法使用可安装触发器，可以让用户首次使用时输入唯一标识（比如邮箱、自定义ID），并存储在用户本地属性中：

function getUserIdentifier() {
  const userProps = PropertiesService.getUserProperties();
  let userId = userProps.getProperty('USER_ID');
  
  if (!userId) {
    const ui = SpreadsheetApp.getUi();
    const result = ui.prompt('请输入你的邮箱或ID：', ui.ButtonSet.OK);
    if (result.getSelectedButton() === ui.Button.OK) {
      userId = result.getResponseText().trim();
      userProps.setProperty('USER_ID', userId);
    } else {
      userId = '未知用户';
    }
  }
  return userId;
}

// 在投票逻辑中调用
function recordVote() {
  const userId = getUserIdentifier();
  Logger.log('投票用户：' + userId);
  // 这里添加投票记录逻辑
}

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