Office.Urls interface

提供加载项使用的运行时环境的 URL。

注解

[ API set: Mailbox 1.14 ]

最低权限级别受限

适用的 Outlook 模式:撰写或阅读

属性

javascriptRuntimeUrl

获取加载项的 JavaScript 运行时的 URL。

属性详细信息

javascriptRuntimeUrl

获取加载项的 JavaScript 运行时的 URL。

javascriptRuntimeUrl: string;

属性值

string

注解

[ API set: Mailbox 1.14 ]

最低权限级别受限

适用的 Outlook 模式:撰写或阅读

重要说明

  • 返回的 URL 指向经典 Outlook on Windows 用于处理基于事件的激活和集成垃圾邮件报告的 JavaScript 文件的位置。 若要了解有关这些功能的详细信息,请参阅 为基于事件的激活配置 Outlook 外接程序实现集成的垃圾邮件报告加载项

  • 在 Outlook 网页版和新 Outlook on Windows 中,实现任务窗格的加载项不支持此 API。 在这些客户端上,API 仅在实现基于事件的激活或集成垃圾邮件报告的加载项中受支持。

  • 如果外接程序使用仅外接程序清单,则返回的 URL 与类型 javascript为 的 RuntimeOverride 元素的值匹配resid。 若要了解详细信息,请参阅 针对运行时重写元素。

  • 如果外接程序使用 Microsoft 365 的统一清单,则返回的 URL 与“extensions.runtimes.code”对象中 属性的值 script 匹配。

示例

// Get the value of the first parameter of the JavaScript runtime URL.
// For example, if the URL is https://wwww.contoso.com/training?key1=value1&key2=value2,
// the following function logs "First parameter value: value1" to the console.
const url = Office.context.urls.javascriptRuntimeUrl;
const regex = /=([^&]+)/;
console.log(`First parameter value: ${url.match(regex)[1]}`);