Outlook JS Web加载项：通过mailto链接启动经典桌面版无法获取收件人字段

问题本质 #

这不是你的操作错误，是经典桌面版Outlook和网页版Outlook在mailto触发撰写窗口时的加载时序差异导致的：

• 网页版Outlook会在触发onNewMessageCompose事件前，把mailto里的收件人数据同步到Office API可访问的邮件对象中
• 经典桌面版Outlook则是先触发加载项的onNewMessageCompose事件，之后才逐步把mailto的收件人数据同步到API层，所以你直接调用getAsync（哪怕加固定延迟）时，数据还没就绪，自然返回空数组。

正确实现方式 #

不要用固定延迟，而是通过监听收件人变化事件来捕获就绪的数据。具体代码如下：

function onNewMessageComposeHandler(event) {
  // 封装通用的获取收件人并处理的函数
  const handleRecipients = (recipientsField) => {
    let gotData = false;
    recipientsField.getAsync((result) => {
      if (result.status === "succeeded" && result.value.length > 0) {
        console.log(`${recipientsField.name} 收件人:`, JSON.stringify(result));
        // 移除监听器（如果存在）
        recipientsField.removeHandlerAsync(Office.EventType.RecipientsChanged);
        gotData = true;
      }
    });
    return gotData;
  };

  // 先尝试获取To、CC、BCC字段
  const toGot = handleRecipients(Office.context.mailbox.item.to);
  const ccGot = handleRecipients(Office.context.mailbox.item.cc);
  const bccGot = handleRecipients(Office.context.mailbox.item.bcc);

  // 对未获取到数据的字段添加监听
  if (!toGot) {
    Office.context.mailbox.item.to.addHandlerAsync(Office.EventType.RecipientsChanged, () => {
      handleRecipients(Office.context.mailbox.item.to);
      event.completed();
    });
  }
  if (!ccGot) {
    Office.context.mailbox.item.cc.addHandlerAsync(Office.EventType.RecipientsChanged, () => {
      handleRecipients(Office.context.mailbox.item.cc);
      event.completed();
    });
  }
  if (!bccGot) {
    Office.context.mailbox.item.bcc.addHandlerAsync(Office.EventType.RecipientsChanged, () => {
      handleRecipients(Office.context.mailbox.item.bcc);
      event.completed();
    });
  }

  // 若所有字段都已获取到数据，直接标记事件完成
  if (toGot && ccGot && bccGot) {
    event.completed();
  }
}

关键说明 #

• 使用Office.EventType.RecipientsChanged事件可以精准捕获收件人数据就绪的时机，比固定延迟更可靠
• 每次获取到有效数据后记得移除监听器，避免后续手动修改收件人时重复触发逻辑
• 必须调用event.completed()，否则加载项会被Office判定为超时未响应

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