Office.Urls interface

参考

包:: office

提供加载项使用的运行时环境的 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]}`);