Поделиться через


Office.Urls interface

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

Комментарии

[ Набор API: Почтовый ящик 1.14 ]

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

Применимый режим Outlook: Compose или чтение

Свойства

javascriptRuntimeUrl

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

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

javascriptRuntimeUrl

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

javascriptRuntimeUrl: string;

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

string

Комментарии

[ Набор API: Почтовый ящик 1.14 ]

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

Применимый режим Outlook: Compose или чтение

Важно!

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

  • В Outlook в Интернете и новом Outlook в Windows этот API не поддерживается в надстройках, реализующих область задач. На этих клиентах API поддерживается только в надстройках, которые реализуют активацию на основе событий или интегрированные отчеты о спаме.

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

  • Если надстройка использует унифицированный манифест для Microsoft 365, возвращенный URL-адрес соответствует значению script свойства в объекте extensions.runtimes.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]}`);