Office-JS Outlook插件：输入TO字段时如何阻止生成错误收件人地址？

碰到过好几个开发者问这个问题了——Outlook在用户输入收件人时的自动临时解析机制确实会给插件的getAsync调用添乱，尤其是你这种高频轮询的场景。针对你说的「阻止创建带部分输入displayName的错误地址」这个需求，给你几个实用的解决方案：

1. 过滤未解析的临时收件人条目 #

Outlook在用户输入过程中生成的那些带空/错误邮箱地址的条目，本质是未完成解析的临时收件人，它们的resolutionStatus属性会标记为Unresolved。你可以在getAsync的回调里过滤掉这类条目，只处理已成功解析的收件人：

Office.context.mailbox.item.to.getAsync(
  { asyncContext: "toRecipients" },
  function (asyncResult) {
    if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
      // 只保留已解析完成的有效收件人
      const validRecipients = asyncResult.value.filter(recipient => 
        recipient.resolutionStatus === Office.MailboxEnums.RecipientResolutionStatus.Resolved
      );
      // 后续只处理validRecipients数组即可
    } else {
      console.error("获取收件人失败:", asyncResult.error);
    }
  }
);

这样你就不会拿到那些临时生成的错误条目，也不用管Outlook是否创建它们——反正你只处理有效数据就行。

2. 用事件监听替代固定频率轮询 #

每秒一次的轮询不仅效率低，还会频繁捕捉到Outlook的临时解析状态。更好的方式是监听TO字段的RecipientsChanged事件，只有当用户完成输入（比如按下回车、Tab，或者Outlook自动完成解析）时才触发查询：

// 先注册收件人变化的监听事件
Office.context.mailbox.item.to.addHandlerAsync(
  Office.EventType.RecipientsChanged,
  function(eventArgs) {
    // 当收件人字段真正完成变更时，再获取有效收件人
    Office.context.mailbox.item.to.getAsync(function(asyncResult) {
      if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
        const validRecipients = asyncResult.value.filter(recipient => 
          recipient.resolutionStatus === Office.MailboxEnums.RecipientResolutionStatus.Resolved
        );
        // 处理有效收件人数据
      }
    });
  },
  function(handlerResult) {
    if (handlerResult.status !== Office.AsyncResultStatus.Succeeded) {
      console.error("注册监听失败:", handlerResult.error);
    }
  }
);

这种方式既减少了不必要的API调用，又能精准获取用户确认后的收件人数据，从根源上避开输入过程中的临时条目干扰。

3. 极端场景下手动清理临时条目（谨慎使用） #

如果你的业务逻辑必须彻底阻止这些临时条目出现在TO字段里，可以在获取到数据后，手动将未解析的条目从TO字段中移除。但要注意：这会打断用户的输入流程，影响体验，所以只建议在特殊场景下使用：

Office.context.mailbox.item.to.getAsync(function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    const validRecipients = asyncResult.value.filter(recipient => 
      recipient.resolutionStatus === Office.MailboxEnums.RecipientResolutionStatus.Resolved
    );
    // 如果当前收件人列表包含临时条目，就更新TO字段
    if (asyncResult.value.length !== validRecipients.length) {
      Office.context.mailbox.item.to.setAsync(validRecipients, function(setResult) {
        if (setResult.status !== Office.AsyncResultStatus.Succeeded) {
          console.error("更新收件人失败:", setResult.error);
        }
      });
    }
  }
});

如果要用这个方法，建议搭配一个输入延迟（比如用户停止输入1秒后再执行），避免频繁触发更新打断用户输入。

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