Office.Urls interface

Пакет:

office

Примечание

Этот API предоставляется в качестве предварительной версии для разработчиков и может быть изменен на основе полученных нами отзывов. Не используйте этот API в рабочей среде.

Предоставляет URL-адреса сред выполнения, используемых надстройкой.

Комментарии

[ Набор API: предварительная версия почтового ящика ]

Минимальный уровень разрешений: ограниченный

Применимый режим Outlook: создание или чтение

Свойства

javascriptRuntimeUrl

Возвращает URL-адрес среды выполнения JavaScript надстройки.

Сведения о свойстве

javascriptRuntimeUrl

Примечание

Этот API предоставляется в качестве предварительной версии для разработчиков и может быть изменен на основе полученных нами отзывов. Не используйте этот API в рабочей среде.

Возвращает URL-адрес среды выполнения JavaScript надстройки.

javascriptRuntimeUrl: string;

Значение свойства

string

Комментарии

[ Набор API: предварительная версия почтового ящика ]

Минимальный уровень разрешений: ограниченный

Применимый режим Outlook: создание или чтение

Важно!

• В настоящее время это свойство находится в предварительной версии в Outlook в Windows. Чтобы протестировать его в надстройке, необходимо установить версию 2401 (сборка 17228.20000) или более позднюю. Затем присоединитесь к программе предварительной оценки Microsoft 365 и выберите параметр Канал бета-версии , чтобы получить доступ к бета-сборкам Office.

• Возвращенный URL-адрес указывает на расположение файла JavaScript, который Outlook в Windows использует для обработки активации на основе событий и интегрированных отчетов о спаме. Дополнительные сведения об этих функциях см. в разделах Настройка надстройки Outlook для активации на основе событий и Реализация интегрированной надстройки отчетов о спаме (предварительная версия).

• Если надстройка использует XML-манифест, возвращенный URL-адрес соответствует resid значению элемента RuntimeOverride типа javascript. Дополнительные сведения см. в разделе Переопределение элемента для среды выполнения.

• Если надстройка использует унифицированный манифест для Microsoft 365 (предварительная версия для разработчиков), возвращенный URL-адрес соответствует значению script свойства в объекте code.

Примеры

// 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]}`);