Office.Urls interface

Obtient l’URL du runtime JavaScript d’un complément.

javascriptRuntimeUrl: string;

Valeur de propriété

Remarques

Jeu d’API : Boîte aux lettres 1.14

Niveau d’autorisation minimal : restreint

Mode Outlook applicable : Rédiger ou Lire

Important:

• L’URL renvoyée pointe vers l’emplacement du fichier JavaScript que Outlook classique sur Windows utilise pour gérer l’activation en fonction des événements et les rapports de courrier indésirable intégrés. Pour en savoir plus sur ces fonctionnalités, voir Activer des compléments avec des événements et Implémenter un complément intégré de signalement du courrier indésirable.

• Dans Outlook sur le web, sur Mac et dans la nouvelle version d’Outlook sur Windows, cette API n’est pas prise en charge dans les compléments qui implémentent un volet Office. Sur ces clients, l’API est uniquement prise en charge dans les compléments qui implémentent l’activation en fonction des événements ou la génération de rapports de courrier indésirable intégrés.

• Si votre complément utilise uniquement le manifeste du complément, l’URL renvoyée correspond à la valeur de l’élément residRuntimeOverride de type javascript. Pour en savoir plus, consultez Remplacer l’élément pour Runtime.

• Si votre complément utilise le manifeste unifié pour Microsoft 365, l’URL renvoyée correspond à la valeur de la script propriété dans l’objet « extensions.runtimes.code ».

Exemples

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