Office.js开发Outlook移动端插件：OnNewMessageCompose事件获取正文失败

针对你在Office.js开发Outlook移动端插件时，延迟10秒获取邮件正文失败的问题，以下是具体的排查和解决方法：

1. 修正代码语法错误 #

原代码中getEmailBody函数的setTimeout参数位置错误，导致语法异常，先修正这一点：

async function getEmailBody() {
  return new Promise((resolve) => {
    setTimeout(() => {
      Office.context.mailbox.item.body.getAsync(Office.CoercionType.Html, (asyncResult) => {
        if (asyncResult.status === Office.AsyncResultStatus.Failed) {
          console.error('获取正文失败:', asyncResult.error.message);
          resolve(null);
        } else {
          resolve(asyncResult.value);
        }
      });
    }, 10 * 1000); // 将延迟时间放在setTimeout的第二个参数位置
  });
}

2. 解决移动端上下文失效问题 #

移动端Outlook的插件生命周期比Web/桌面端更严格，延迟10秒后可能已经丢失了邮件项的上下文，建议提前保存mailbox.item的引用：

async function newMessageCompose(event) {
  // 提前保存当前邮件项的引用，避免延迟后上下文失效
  const currentMailItem = Office.context.mailbox.item;

  async function getEmailBody() {
    return new Promise((resolve) => {
      setTimeout(() => {
        currentMailItem.body.getAsync(Office.CoercionType.Html, (asyncResult) => {
          if (asyncResult.status === Office.AsyncResultStatus.Failed) {
            console.error('获取失败:', asyncResult.error);
            resolve(null);
          } else {
            resolve(asyncResult.value);
          }
        });
      }, 10 * 1000);
    });
  }

  const body = await getEmailBody();
  console.log(body);
  // 确保所有异步操作完成后再调用event.completed()
  event.completed();
}

3. 换用事件监听替代延迟获取 #

如果业务允许，建议通过监听正文变化事件来获取内容，避免依赖固定延迟（移动端延迟操作容易触发上下文回收）：

function newMessageCompose(event) {
  const currentMailItem = Office.context.mailbox.item;
  let timeoutId;

  // 正文变化的处理函数
  const handleBodyChange = () => {
    currentMailItem.body.getAsync(Office.CoercionType.Html, (result) => {
      if (result.status === Office.AsyncResultStatus.Succeeded) {
        console.log('获取到正文:', result.value);
        clearTimeout(timeoutId);
        // 移除事件监听
        currentMailItem.body.removeHandlerAsync(Office.EventType.BodyChanged, () => {});
        event.completed();
      }
    });
  };

  // 注册正文变化事件
  currentMailItem.body.addHandlerAsync(Office.EventType.BodyChanged, handleBodyChange, (addResult) => {
    if (addResult.status === Office.AsyncResultStatus.Failed) {
      console.error('注册事件失败:', addResult.error);
    }

    // 10秒后若未触发变化，主动获取正文
    timeoutId = setTimeout(() => {
      currentMailItem.body.removeHandlerAsync(Office.EventType.BodyChanged, () => {});
      currentMailItem.body.getAsync(Office.CoercionType.Html, (result) => {
        console.log('超时后获取正文:', result.value || '正文为空');
        event.completed();
      });
    }, 10 * 1000);
  });
}

4. 额外排查点 #

• 权限配置：确保插件manifest.xml中声明了ReadWriteMailbox权限，否则无法读取邮件正文。
• API兼容性：移动端可能对Office.CoercionType.Html支持有限，可尝试切换为Office.CoercionType.Text测试是否能正常获取内容。
• Office.js版本：使用最新版的Office.js库，避免旧版本的移动端兼容性问题。

内容的提问来源于stack exchange，提问作者Fatih Karameşe