Office.Urls interface

Ruft die URL der JavaScript-Laufzeit eines Add-Ins ab.

javascriptRuntimeUrl: string;

Eigenschaftswert

Hinweise

API-Satz: Postfach 1.14

Mindestberechtigungsstufe: Eingeschränkt

Anwendbarer Outlook-Modus: Compose oder Lesen

Wichtig:

• Die zurückgegebene URL verweist auf den Speicherort der JavaScript-Datei, die vom klassischen Outlook unter Windows für die ereignisbasierte Aktivierung und integrierte Spamberichterstattung verwendet wird. Weitere Informationen zu diesen Features finden Sie unter Aktivieren von Add-Ins mit Ereignissen und Implementieren eines integrierten Add-In für die Spamberichterstattung.

• In Outlook im Web, auf dem Mac und im neuen Outlook unter Windows wird diese API in Add-Ins, die einen Aufgabenbereich implementieren, nicht unterstützt. Auf diesen Clients wird die API nur in Add-Ins unterstützt, die eine ereignisbasierte Aktivierung oder integrierte Spamberichterstattung implementieren.

• Wenn Ihr Add-In das Nur-Add-In-Manifest verwendet, stimmt die zurückgegebene URL mit dem resid Wert des RuntimeOverride-Elements vom Typ .javascript Weitere Informationen finden Sie unter Override-Element für Runtime.

• Wenn Ihr Add-In das einheitliche Manifest für Microsoft 365 verwendet, stimmt die zurückgegebene URL mit dem Wert der script Eigenschaft im Objekt "extensions.runtimes.code" überein.

Beispiele

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