Google Form中item.asTextItem()抛出TypeError错误的排查与解决

在Google Apps Script操作Google Form时，代码逻辑上仅当项目类型为TEXT时才会执行return item.asTextItem();，但实际运行时却抛出TypeError: item.asTextItem is not a function错误，请问问题原因及解决方案是什么？

问题原因分析 #

• TEXT类型包含两种子类型：Google Form的FormApp.ItemType.TEXT同时指代单行文本（Short Answer）和多行文本（Paragraph Text），但asTextItem()方法仅属于单行文本项目。如果获取到的item是多行文本类型，即使getType()返回TEXT，调用asTextItem()也会报错，因为多行文本对应的方法是asParagraphTextItem()。
• 旧项目匹配错误：在updateQuestionItem_函数中，通过标题获取旧项目时，若存在标题重复的情况，会意外获取到非预期类型的项目（比如多行文本），但类型判断仍返回TEXT，进而触发错误的方法调用。
• 类型判断精度不足：仅依赖getType()无法区分TEXT类型下的单行/多行文本，导致方法调用与实际项目类型不匹配。

解决方案 #

1. 优化类型转换逻辑，兼容单行/多行文本 #

修改ConvertGeneric2SpecificItem_函数，在TEXT分支中容错处理，优先尝试单行文本转换，失败则转为多行文本：

function ConvertGeneric2SpecificItem_(item) {
  try {
    switch (item.getType()) {
      case FormApp.ItemType.MULTIPLE_CHOICE:
        return item.asMultipleChoiceItem();
      case FormApp.ItemType.CHECKBOX:
        return item.asCheckboxItem();
      case FormApp.ItemType.LIST:
        return item.asListItem();
      case FormApp.ItemType.TEXT:
        // 优先尝试单行文本转换，失败则返回多行文本对象
        try {
          return item.asTextItem();
        } catch (e) {
          return item.asParagraphTextItem();
        }
      case FormApp.ItemType.PARAGRAPH_TEXT:
        return item.asParagraphTextItem();
      case FormApp.ItemType.DATE:
        return item.asDateItem();
      case FormApp.ItemType.TIME:
        return item.asTimeItem();
      default:
        Logger.log(`无效项目类型: ${item.getType()}`);
        return item; // 返回原对象避免后续null报错
    }
  } catch (error) {
    Logger.log(`转换项目出错: ${error.message}`);
    return item;
  }
}

2. 修复旧项目获取逻辑，优先用ID匹配 #

标题可能重复，优先通过itemId获取项目，避免类型匹配错误：

function updateQuestionItem_(form, config, row, cols, existingStructureArr, questionCount, position) {
  const itemId = row[cols.id];
  const oldItemIndex = existingStructureArr.indexOf(itemId);
  
  let item;
  if (oldItemIndex >= 0) {
    // 优先用ID获取项目，标题作为备选
    item = form.getItemById(itemId);
    if (!item) {
      const oldTitle = existingStructureArr[oldItemIndex + 1];
      item = GetQuestionItemInFormByTitle_(oldTitle, form);
    }
    form.moveItem(item, position - 1);
    
    const isChoiceQuestion = item.getType() == FormApp.ItemType.MULTIPLE_CHOICE || item.getType() == FormApp.ItemType.CHECKBOX;
    if(isChoiceQuestion) applyChoices_(item, row, cols, config);
  } else {
    item = createFormItem_(form, row, config, cols, questionCount)
  }

  applyCommonProperties_(item, row, cols, questionCount);
  return item;
}

3. 确保更新时类型一致性 #

若旧项目类型与预期不符，删除旧项目重新创建：

if (oldItemIndex >= 0) {
  item = form.getItemById(itemId);
  // 检查项目类型是否符合预期，不符合则删除重建
  if (item && item.getType() !== FormApp.ItemType.TEXT) {
    form.deleteItem(item);
    item = createFormItem_(form, row, config, cols, questionCount);
  } else if (!item) {
    const oldTitle = existingStructureArr[oldItemIndex + 1];
    item = GetQuestionItemInFormByTitle_(oldTitle, form);
    if (!item) {
      item = createFormItem_(form, row, config, cols, questionCount);
    }
  }
  form.moveItem(item, position - 1);
  // ... 后续逻辑
}

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