使用Word任务窗格加载项报错:Property 'actions' does not exist on type 'typeof Office'
自定义快捷键功能报错排查方案
- 运行环境不满足最低要求
Office.actions属于较新的 Office 扩展API,仅支持 Office 2021 及以上版本、微软365订阅版客户端,同时要求加载的 Office.js 版本不低于1.1。如果你的运行环境是旧版Office,会直接识别不到actions属性,你可以先核对运行环境版本是否符合要求。 - TypeScript类型定义缺失
如果你的项目使用TypeScript开发,该报错大概率是本地安装的@types/office-js类型包版本过旧,没有包含actions相关的类型声明。你可以先更新类型包到最新版,执行命令:npm install @types/office-js@latest --save-dev
如果更新后仍有类型报错,可以临时用类型断言绕过编译校验,代码示例:
(Office as any).actions.associate('SHOWTASKPANE', function () { return Office.addin.showAsTaskpane() .then(function () { return; }) .catch(function (error) { return error.code; }); });
- 代码执行时机错误
Office.actions相关调用必须在Office库完全初始化完成后执行,你需要把这段逻辑放在Office.onReady()的回调函数内,正确写法示例:
Office.onReady() .then(() => { Office.actions.associate('SHOWTASKPANE', function () { return Office.addin.showAsTaskpane() .then(function () { return; }) .catch(function (error) { return error.code; }); }); });
- Addin清单配置错误
你需要确认你的插件manifest文件已经正确添加了KeyboardShortcuts扩展权限,同时配置的动作ID和代码里的SHOWTASKPANE完全匹配,清单配置异常也会导致相关API加载失败。
内容的提问来源于stack exchange,提问作者ReaperSixt
相关产品推荐
相关产品推荐

