调用Office JS API打开预填充Outlook约会窗口报方法未定义错误

你触发Uncaught TypeError: Cannot read properties of undefined (reading 'displayNewAppointmentFormAsync')是三个核心问题导致的：

• displayNewAppointmentFormAsync是Outlook插件专属API，只能运行在Outlook加载的插件上下文里，普通独立HTML/JS Web应用没有Office宿主注入的运行时环境，根本不存在Office.context.mailbox这个对象，自然读不到对应方法。
• 就算你是在开发Outlook插件，直接在页面加载时就调用API也会报错：Outlook JS库必须等Office.onReady初始化事件触发后，才能正常访问mailbox下的所有方法，初始化未完成时Office.context.mailbox值为undefined。
• 额外注意：displayNewAppointmentFormAsync要求Outlook插件的最低要求集版本为1.9，低版本Outlook客户端不支持这个异步方法。

根据你的实际开发场景选对应方案即可：

场景1：你正在开发Outlook插件 #

按以下两点修正代码即可：

• 所有Office API调用必须放在Office.onReady初始化回调之后执行，不要直接在页面加载流程里调用
• 做方法存在性判断，兼容不支持1.9要求集的低版本Outlook客户端

修正后的可运行代码：

// 等待Office宿主环境初始化完成
Office.onReady(info => {
  if (info.host !== Office.HostType.Outlook) return;
  // 初始化完成后再绑定按钮点击事件
  document.querySelector("#create-appointment-btn").addEventListener("click", () => {
    const start = new Date();
    const end = new Date();
    end.setHours(start.getHours() + 1);

    const formParams = {
      requiredAttendees: ["bob@contoso.com"],
      optionalAttendees: ["sam@contoso.com"],
      start: start,
      end: end,
      location: "Home",
      subject: "meeting",
      resources: ["projector@contoso.com"],
      body: "Hello World!"
    };

    // 优先用异步方法，不支持则降级到同步版本
    if (Office.context.mailbox.displayNewAppointmentFormAsync) {
      Office.context.mailbox.displayNewAppointmentFormAsync(formParams, res => {
        console.log(JSON.stringify(res));
      });
    } else {
      Office.context.mailbox.displayNewAppointmentForm(formParams);
    }
  });
});

场景2：你开发的是普通独立Web应用，不是Outlook插件 #

这种场景无法使用Outlook JavaScript API（浏览器安全限制下普通网页没有权限直接接入本地Outlook客户端的API能力），要实现点击按钮唤起Outlook新建约会窗口，直接用mailto协议即可，不需要引入Office JS库：

document.querySelector("#create-appointment-btn").addEventListener("click", () => {
  const start = new Date();
  const end = new Date();
  end.setHours(start.getHours() + 1);

  const query = new URLSearchParams({
    subject: "meeting",
    location: "Home",
    body: "Hello World!",
    to: "bob@contoso.com,sam@contoso.com"
  });
  // 唤起系统默认邮件客户端，如果Outlook是默认邮件客户端就会直接打开预填充的新建约会窗口
  window.location.href = `mailto:?${query.toString()}`;
});

注意：这种协议唤起的方式受用户系统默认应用设置影响，如果用户默认邮件客户端不是Outlook，会唤起其他对应邮件应用，普通网页没有权限强制指定打开Outlook。

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