Office.Urls interface

包:

office

注意

此 API 以预览状态提供给开发者，可能根据我们收到的反馈更改。 请勿在生产环境中使用此 API。

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

注解

[ API 集：邮箱预览 ]

最低权限级别： 受限

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

属性

javascriptRuntimeUrl

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

属性详细信息

javascriptRuntimeUrl

注意

此 API 以预览状态提供给开发者，可能根据我们收到的反馈更改。 请勿在生产环境中使用此 API。

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

javascriptRuntimeUrl: string;

属性值

string

注解

[ API 集：邮箱预览 ]

最低权限级别： 受限

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

重要说明：

• 此属性目前在 Outlook on Windows 中处于预览状态。 若要在外接程序中对其进行测试，必须安装版本 2401 (内部版本 17228.20000) 或更高版本。 然后，加入 Microsoft 365 预览体验计划 ，并选择 “Beta 频道” 选项以访问 Office beta 版本。

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

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

• 如果外接程序使用 Microsoft 365 的统一清单，则返回的 URL 与“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]}`);