如何为Office-JS Word插件的Word.DocumentCreated对象更新目录？

目录是否属于Field？ #

是的，Word中的目录（TOC）属于Word.Field对象，对应的字段类型为wdFieldTOC。

查找并更新目录的方法 #

1. 更新所有目录字段 #

通过字段类型筛选出所有目录，批量更新：

await Word.run(async (context) => {
  // 获取文档中所有目录类型的字段
  const tocFields = context.document.body.fields.getByType(Word.FieldType.toc);
  tocFields.load("items");
  await context.sync();

  // 遍历更新每个目录
  tocFields.items.forEach(field => {
    field.update();
  });

  await context.sync();
});

2. 更新特定目录 #

如果文档存在多个目录，可定位单个目录进行更新：

await Word.run(async (context) => {
  // 获取文档中的第一个目录
  const firstToc = context.document.body.fields.getByType(Word.FieldType.toc).getFirst();
  firstToc.load();
  await context.sync();

  if (firstToc) {
    firstToc.update();
    await context.sync();
  }
});

3. 操作文档后同步更新目录 #

在完成文档创建或内容修改后，直接执行更新逻辑：

// 先完成文档内容操作/创建
await Word.run(async (context) => {
  // 保存文档（按需执行）
  await context.document.save();
  
  // 更新所有目录
  const tocFields = context.document.body.fields.getByType(Word.FieldType.toc);
  tocFields.load("items");
  await context.sync();
  
  tocFields.items.forEach(field => field.update());
  await context.sync();
});

注意：更新目录前确保所有标题类内容已修改完成，避免出现更新不完整的情况。

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