如何用Google Apps Script获取Google Docs中复选框的状态？

当然可以用Google Apps Script获取Google Docs中的所有复选框并判断其勾选状态，你的代码报错和无法识别复选框的原因及解决方案如下：

错误原因 #

1. getListItems()会返回文档中所有列表项，但部分列表项的getGlyphType()方法会返回null（比如特殊格式的嵌套列表或空列表项），直接调用toString()就会触发TypeError: Cannot read properties of null (reading 'toString')。
2. 未针对复选框的特定枚举值做判断，导致无法区分项目符号和复选框类型。

修改后的代码实现 #

以下是可正确获取所有复选框及其勾选状态的代码，同时避免了null报错：

function getCheckboxValues() {
  const doc = DocumentApp.getActiveDocument();
  const body = doc.getBody();
  const listItems = body.getListItems();
  const checkboxData = [];

  for (const item of listItems) {
    // 跳过无符号类型的列表项，避免null报错
    const glyphType = item.getGlyphType();
    if (!glyphType) continue;

    // 判断当前列表项是否为复选框类型
    const isCheckbox = [
      DocumentApp.GlyphType.CHECKBOX_CHECKED,
      DocumentApp.GlyphType.CHECKBOX_UNCHECKED
    ].includes(glyphType);

    if (isCheckbox) {
      // 获取复选框的文本内容和勾选状态
      const itemText = item.getText().trim();
      const isChecked = item.isChecked();
      
      checkboxData.push({
        text: itemText,
        checked: isChecked
      });
      
      // 控制台打印结果，方便调试
      console.log(`复选框内容: ${itemText}, 已勾选: ${isChecked}`);
    }
  }

  // 此处可将checkboxData同步到外部数据库
  // 示例（替换为你的数据库API）：
  // UrlFetchApp.fetch('你的数据库API地址', {
  //   method: 'POST',
  //   contentType: 'application/json',
  //   payload: JSON.stringify(checkboxData)
  // });

  return checkboxData;
}

代码说明 #

• 避免null报错：遍历列表项时先检查glyphType是否存在，跳过无符号类型的项。
• 识别复选框：通过DocumentApp.GlyphType枚举中的CHECKBOX_CHECKED和CHECKBOX_UNCHECKED判断是否为复选框。
• 获取勾选状态：使用item.isChecked()方法直接获取复选框的勾选状态，比判断符号类型更直观可靠。
• 数据同步：收集到的checkboxData数组包含每个复选框的文本和状态，可通过UrlFetchApp调用外部数据库API完成数据填充。

额外提示 #

如果只需处理文档中特定区域的复选框，可以先定位到目标段落或章节（比如通过body.getParagraphs()或body.getSection()），再对目标区域调用getListItems()，缩小遍历范围。

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