如何为已上架AppSource的Outlook add-in开展自动化E2E test

官方测试工具与落地方案 #

• 微软暂无专门针对Outlook插件的专属E2E测试工具，目前行业通用的可落地方案基于通用Web自动化框架实现，兼容Web端与桌面端Outlook场景：
  • 优先选择Playwright或Selenium作为自动化测试框架，针对Outlook Web App(OWA)环境编写测试用例：先模拟账号登录测试租户，进入插件对应的触发场景（如邮件阅读页、新建邮件页），模拟点击功能区的插件唤起按钮，等待插件的iframe加载完成后切入iframe上下文，即可执行插件的功能交互测试，需要注意为OWA的动态懒加载元素设置合理的等待判定逻辑，避免用例不稳定。
  • 如果需要覆盖桌面端Outlook的测试场景，可以搭配Edge Driver操作桌面端Outlook内置的WebView2控件，核心测试逻辑和OWA端完全复用，仅需要额外处理桌面端的窗口唤起逻辑即可。
  • 测试前需要提前在测试租户中预安装待测试版本的插件，关闭插件的权限申请、安装确认等弹窗步骤，避免打断自动化流程。

Outlook 上下文Mock方案 #

• 针对单独运行插件Web应用时缺失window.Office完整上下文的问题，微软官方提供了office-addin-mock库，专门用于测试阶段模拟完整的Office.js上下文对象，支持自定义所有Outlook相关的属性与方法返回值，不需要依赖Outlook客户端即可完成单元测试、集成测试。
• 基础使用示例如下：

import { OfficeMockObject } from 'office-addin-mock';

// 构造自定义的Outlook上下文模拟数据
const officeMock = new OfficeMockObject({
  context: {
    mailbox: {
      item: {
        subject: '测试邮件主题',
        to: [{ displayName: '测试用户', emailAddress: 'test@contoso.com' }],
        body: {
          getAsync: async (options, callback) => {
            callback({ value: '测试邮件正文内容', status: Office.AsyncResultStatus.Succeeded });
          }
        }
      }
    }
  }
});

// 将模拟对象挂载到全局window，替代真实的Office.js上下文
global.Office = officeMock;

• 如果需要更贴近生产的运行环境，也可以使用office-addin-debugging工具启动本地调试容器，注入接近真实的Office上下文桩，无需启动完整Outlook客户端即可拿到完整的上下文能力。

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