Office JS插件中如何检测Word文档修改保存及处理保存关闭事件？

1. 保存事件处理 #

目前Office JS没有直接的保存触发事件钩子，但可以通过两种间接方式实现类似需求：

• 轮询document.saved属性：定时检查该属性的状态变化，当从false变为true时，判定文档完成保存，此时执行页脚编辑操作。示例代码：

let lastSavedState = Word.run(async (context) => {
  const doc = context.document;
  doc.load("saved");
  await context.sync();
  return doc.saved;
});

setInterval(async () => {
  const currentState = await Word.run(async (context) => {
    const doc = context.document;
    doc.load("saved");
    await context.sync();
    return doc.saved;
  });
  if (!lastSavedState && currentState) {
    // 文档刚完成保存，执行页脚编辑逻辑
    await updateFooter();
  }
  lastSavedState = currentState;
}, 1000); // 每秒检查一次，可根据需求调整间隔

• 监听内容变更+手动触发：在用户修改文档时（通过ContentChanged事件）记录状态，结合插件内的"保存"按钮触发操作，但这种方式无法覆盖用户通过Office自带保存按钮的场景。

2. 关闭事件处理 #

Office JS提供了Office.EventType.DocumentBeforeClose事件，可在文档关闭前触发自定义逻辑，示例代码：

Office.context.document.addHandlerAsync(
  Office.EventType.DocumentBeforeClose,
  async (eventArgs) => {
    // 执行关闭前的操作，比如编辑页脚
    await updateFooter();
    // 如果需要阻止关闭，可设置eventArgs.cancel = true;
    // eventArgs.cancel = true;
  }
);

注意：这个事件在用户关闭文档、关闭应用程序或切换到其他文档时都会触发，需根据业务逻辑判断是否需要执行操作。

补充：上述updateFooter是自定义的页脚编辑函数，示例实现如下：

async function updateFooter() {
  await Word.run(async (context) => {
    const sections = context.document.sections;
    sections.load("items");
    await context.sync();
    for (let section of sections.items) {
      const footer = section.getFooter(Word.HeaderFooterType.primary);
      footer.insertText("动态更新的页脚内容", Word.InsertLocation.replace);
    }
    await context.sync();
  });
}

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