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 仅在实现基于事件的激活或集成垃圾邮件报告的加载项中受支持。

• 如果外接程序使用 XML 清单，则返回的 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]}`);