React开发Word Add-In时Track Changes功能异常求助

问题说明 #

需求：通过算法在Word文档中以Track Changes模式自动将字符串“§ 210”替换为“§ 211”，要求与原生手动操作一致：

• 接受/拒绝修改后仅保留原内容或修正内容
• 不会对已存在修正建议的字符串重复添加修正

当前实现存在的问题：

• 用户需分别接受/拒绝原内容与修正内容，无法一键处理替换操作
• 已存在修正的字符串会被重复处理，出现双重修正（如执行结果示例：§ 210§ 211§ 211，后两个带下划线）

现有代码 #

export async function correctSpellingMistakes() {
  const searchWord = "§ 210";
  const suggestion = "§ 211";

  try {
    await Word.run(async (context) => {
      const body = context.document.body;
      const searchResults = body.search(searchWord, { matchCase: false, matchWholeWord: true });

      context.load(searchResults, 'items');

      await context.sync();

      await setChangeTrackingMode("trackAll");

      if (searchResults.items.length > 0) {
        for (let i = 0; i < searchResults.items.length; i++) {
          const match = searchResults.items[i];

          match.font.strikeThrough = true;

          match.insertText(`${suggestion}`, 'After');
        }

        await context.sync();
      }

      await setChangeTrackingMode("off");

      await context.sync();
    });
  } catch (error) {
    console.error('Error:', error);
  }
}

问题根源 #

现有代码通过手动给原文本加删除线、插入新文本的方式模拟替换，这会生成两个独立的修改项，而非原生替换操作的单一修改项。同时未过滤已被标记为删除的内容，导致重复处理。

修正后的代码 #

export async function correctSpellingMistakes() {
  const searchWord = "§ 210";
  const suggestion = "§ 211";

  try {
    await Word.run(async (context) => {
      const body = context.document.body;
      // 搜索时忽略已被标记为删除的内容，避免重复处理
      const searchResults = body.search(searchWord, { 
        matchCase: false, 
        matchWholeWord: true,
        ignoreDeleted: true
      });

      context.load(searchResults, 'items');
      await context.sync();

      // 开启Track Changes模式
      await context.document.trackChanges.toggle(true);

      if (searchResults.items.length > 0) {
        // 倒序遍历，避免替换后文档结构变化影响后续匹配项位置
        for (let i = searchResults.items.length - 1; i >= 0; i--) {
          const match = searchResults.items[i];
          // 额外检查内容是否已被标记为删除，进一步防止重复修正
          context.load(match, 'font/strikeThrough');
          await context.sync();
          if (match.font.strikeThrough) {
            continue;
          }
          // 使用replaceWith方法，自动生成原生替换的Track Changes标记
          match.replaceWith(suggestion);
        }
        await context.sync();
      }

      // 关闭Track Changes模式
      await context.document.trackChanges.toggle(false);
      await context.sync();
    });
  } catch (error) {
    console.error('Error:', error);
  }
}

关键修复点 #

• 使用replaceWith方法：在Track Changes模式下，该方法会自动将原内容标记为删除、新内容标记为插入，且作为单一修改项，用户可一键接受/拒绝。
• 搜索配置ignoreDeleted: true：直接过滤已被标记为删除的内容，避免重复处理。
• 倒序遍历匹配项：防止替换操作导致文档内容偏移，影响后续匹配项的定位。
• 额外检查删除状态：双重保险，避免遗漏的已删除内容被重复修正。

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