Office.Urls interface
Provides the URLs of the runtime environments used by an add-in.
Remarks
Minimum permission level: restricted
Applicable Outlook mode: Compose or Read
Properties
javascript |
Gets the URL of the JavaScript runtime of an add-in. |
Property Details
javascriptRuntimeUrl
Gets the URL of the JavaScript runtime of an add-in.
javascriptRuntimeUrl: string;
Property Value
string
Remarks
Minimum permission level: restricted
Applicable Outlook mode: Compose or Read
Important:
The URL that's returned points to the location of the JavaScript file that classic Outlook on Windows uses to handle event-based activation and integrated spam reporting. To learn more about these features, see Configure your Outlook add-in for event-based activation and Implement an integrated spam-reporting add-in.
In Outlook on the web and new Outlook on Windows, this API isn't supported in add-ins that implement a task pane. On these clients, the API is only supported in add-ins that implement event-based activation or integrated spam reporting.
If your add-in uses the add-in only manifest, the URL returned matches the
resid
value of the RuntimeOverride element of typejavascript
. To learn more, see Override element for Runtime.If your add-in uses the unified manifest for Microsoft 365, the URL returned matches the value of the
script
property in the "extensions.runtimes.code" object.
Examples
// 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]}`);
Office Add-ins