如何用Office JavaScript API获取Word的parentSectionOrNullObject范围？报错求解

错误原因 #

你遇到的TypeError: Cannot read properties of undefined (reading 'isNullObject')，本质是selection.parentSectionOrNullObject未被正确加载，或是当前API环境不支持该属性导致其返回undefined。

Office JavaScript API采用延迟加载机制，仅加载你显式指定的属性。你当前只加载了parentSectionOrNullObject这个对象引用，但未加载其内部的isNullObject属性；同时如果你的Office版本对应的API低于1.3，parentSectionOrNullObject本身就不存在。

解决方案 #

1. 修正属性加载方式 #

需要明确加载parentSectionOrNullObject的isNullObject属性，同时后续操作中确保正确加载section的范围属性：

async function getSectionRange() {
  try {
    await Word.run(async (context) => {
      const selection = context.document.getSelection();
      // 加载parentSectionOrNullObject及其isNullObject属性
      selection.load('parentSectionOrNullObject/isNullObject');
      await context.sync();

      // 先判断parentSectionOrNullObject是否存在，再检查isNullObject
      if (selection.parentSectionOrNullObject && !selection.parentSectionOrNullObject.isNullObject) {
        const parentSection = selection.parentSectionOrNullObject;
        const sectionRange = parentSection.getRange("Whole");
        // 加载sectionRange的text属性
        sectionRange.load('text');
        await context.sync();
        console.log('Section Range Text:', sectionRange.text);
      } else {
        console.log('选中内容不属于任何章节，或API版本不支持该属性');
      }
    });
  } catch (error) {
    console.error('Error: ', error);
  }
}

2. 确认API版本兼容性 #

parentSectionOrNullObject是Word JavaScript API 1.3版本引入的属性，你需要确保：

• 使用最新的Office 365订阅版（旧版本可能不支持该API）
• 在插件清单文件（manifest.xml）中指定的Requirements至少包含WordApi 1.3：

<Requirements>
  <Sets DefaultMinVersion="1.3">
    <Set Name="WordApi" MinVersion="1.3"/>
  </Sets>
</Requirements>

3. 特殊场景排查 #

如果选中内容处于页眉、页脚或文本框等特殊区域，可能导致parentSectionOrNullObject无法正确获取，可先判断选中内容的类型：

selection.load('type');
await context.sync();
console.log('选中内容类型:', selection.type);

若类型为HeaderFooter或TextBoxContentControl等，需要调整获取section的逻辑。

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