Mac Outlook 16.77插件通过JS API无法正常获取附件格式/内容

问题详情 #

• 版本差异：Mac Outlook 16.77（23091003）中，基于JS API开发的插件无法正常获取附件格式与内容；但相同的插件代码、manifest配置在Outlook 16.75.1（23071400）版本可正常执行。
• 触发异常场景：用户发送带附件的邮件时，插件尝试获取附件详情，访问result.value.format变量会抛出异常（相关错误截图可直观显示异常信息）。
• 复现路径：使用Office JS API中获取附件内容格式的标准示例代码即可复现该问题。

临时解决方案与排查建议 #

1. 代码层面兼容处理 #

在访问result.value.format前增加存在性校验，避免直接访问不存在的属性导致异常；若属性缺失，可通过附件扩展名推断格式：

// 假设已获取到附件内容结果result
if (result.value && Object.prototype.hasOwnProperty.call(result.value, 'format')) {
    const attachmentFormat = result.value.format;
    // 执行正常格式处理逻辑
} else {
    // 从附件名称推断格式的兼容逻辑
    const targetAttachment = /* 获取当前操作的附件对象 */;
    const fileExt = targetAttachment.name.split('.').pop()?.toLowerCase() || '';
    let inferredFormat;

    switch(fileExt) {
        case 'txt':
        case 'md':
            inferredFormat = 'text';
            break;
        case 'pdf':
            inferredFormat = 'pdf';
            break;
        case 'docx':
        case 'xlsx':
        case 'pptx':
            inferredFormat = 'office';
            break;
        default:
            inferredFormat = 'binary';
    }
    // 使用推断的格式继续后续处理
}

2. 提交官方Bug反馈 #

该问题属于版本回归问题，建议通过以下方式反馈：

• 打开Outlook，点击顶部菜单栏的「帮助」→「反馈」，提交包含版本号、复现步骤、错误截图的详细bug报告；
• 通过Office 365管理中心的支持渠道提交技术工单，推动官方修复该API兼容性问题。

3. 临时版本降级 #

若业务对该功能稳定性要求较高，可指导用户临时降级到Outlook 16.75.1版本，确保插件功能正常运行，待官方发布修复版本后再升级。

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