基于JavaScript的Office Add-in如何捕获OnSave()事件？

你在官方文档里找不到OnSave()、OnClose()事件是正常的——Office 对象模型从始至终没有提供这两个命名的事件，所有保存、关闭相关的捕获逻辑都要通过Application对象级的全局事件实现，具体落地方案如下：

核心事件绑定 #

你需要在插件加载完成后，绑定三个Application级事件覆盖所有保存、关闭场景：

• DocumentBeforeSave：所有保存动作（包括快捷键保存、按钮点击保存、关闭时触发的提示保存、另存为）执行前触发，是整个采集逻辑的入口
• DocumentBeforeClose：文档关闭动作执行前触发，用来兜底捕获用户点关闭按钮时弹出保存提示的场景，避免漏采
• AfterSave：Office 2010及以上版本支持，保存动作执行完成后触发，用来确认保存结果、拿到最终存储路径
  注意：不要使用单文档对象下的Save事件，该事件无法响应另存为操作，会出现数据漏采。

三类目标信息的采集方法 #

• 创建/编辑人员身份信息
  可直接读取文档内置属性：创建作者取BuiltInDocumentProperties("Author")字段，最后编辑人员取BuiltInDocumentProperties("Last Author")字段。如果需要更高准确性的身份校验，可同步读取当前Windows系统登录用户名、SID做关联，避免用户手动修改Office文档属性伪造身份信息。
• 原存储路径、另存为新路径
  进入DocumentBeforeSave事件时，首先读取当前文档对象的FullName属性值，即为本次操作前的原存储路径。事件自带的SaveAsUI布尔参数值为true时，代表本次操作会弹出另存为对话框（新建文档第一次保存时该参数也为true，此时原路径为空，可标记为新建文档首次保存场景），等AfterSave事件触发后，再次读取文档的FullName属性，即为另存为操作后的新路径；如果是普通覆盖保存，保存前后路径一致，无新路径字段。
• 文档具体变更内容
  不同Office应用的采集逻辑有差异：
  • Word：开启文档修订跟踪能力，保存前遍历文档的Revisions集合，即可拿到所有增删改的内容、位置、对应操作人、操作时间；采集完成后可隐藏修订标记，不影响用户正常编辑体验。
  • Excel：绑定SheetChange事件，实时将单元格变更的工作表、行列位置、原值、新值存在内存缓存中，触发保存时批量导出缓存内容即可；涉及公式、图表、形状的变更，可配合SheetCalculate、形状变更相关事件做补充采集。
  • PPT：没有内置细粒度变更跟踪接口，可在插件加载、每次保存完成后对每页幻灯片的元素生成特征快照，下次保存前用快照和当前文档内容做逐元素对比，标记出新增、删除、修改的内容。

避坑提示 #

• 若需要覆盖桌面端全版本Office的操作场景，优先选择VSTO或COM加载项方案，Office Web Add-in的事件权限较低，无法全局捕获所有保存触发入口。
• 处理DocumentBeforeSave事件时，无特殊拦截需求不要将事件参数Cancel设为true，否则会打断用户正常的保存流程。
• 变更内容采集尽量用编辑时增量记录的方式实现，不要每次保存都做全文档扫描，避免占用过多资源导致Office卡顿。

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