@microsoft/teams-js 2.19.0-beta.2 → 2.19.0-beta.3

package/dist/MicrosoftTeams.d.ts

@@ -7587,7 +7587,7 @@ export namespace teamsCore {
         /**
             * Registers a handler to be called when the page has been requested to load.
             *
-            * @remarks Check out [App Caching in Teams](https://learn.microsoft.com/microsoftteams/platform/apps-in-teams-meetings/build-tabs-for-meeting?tabs=desktop%2Cmeeting-chat-view-desktop%2Cmeeting-stage-view-desktop%2Cchannel-meeting-desktop#app-caching)
+            * @remarks Check out [App Caching in Teams](https://learn.microsoft.com/en-us/microsoftteams/platform/tabs/how-to/app-caching)
             * for a more detailed explanation about using this API.
             *
             * @param handler - The handler to invoke when the page is loaded.
@@ -7611,7 +7611,7 @@ export namespace teamsCore {
         /**
             * Registers a handler to be called before the page is unloaded.
             *
-            * @remarks Check out [App Caching in Teams](https://learn.microsoft.com/microsoftteams/platform/apps-in-teams-meetings/build-tabs-for-meeting?tabs=desktop%2Cmeeting-chat-view-desktop%2Cmeeting-stage-view-desktop%2Cchannel-meeting-desktop#app-caching)
+            * @remarks Check out [App Caching in Teams](https://learn.microsoft.com/en-us/microsoftteams/platform/tabs/how-to/app-caching)
             * for a more detailed explanation about using this API.
             *
             * @param handler - The handler to invoke before the page is unloaded. If this handler returns true the page should

package/dist/MicrosoftTeams.js

@@ -764,6 +764,36 @@ function plural(ms, msAbs, n, name) {
 /******/ 	}
 /******/ 	
 /************************************************************************/
+/******/ 	/* webpack/runtime/create fake namespace object */
+/******/ 	(() => {
+/******/ 		var getProto = Object.getPrototypeOf ? (obj) => (Object.getPrototypeOf(obj)) : (obj) => (obj.__proto__);
+/******/ 		var leafPrototypes;
+/******/ 		// create a fake namespace object
+/******/ 		// mode & 1: value is a module id, require it
+/******/ 		// mode & 2: merge all properties of value into the ns
+/******/ 		// mode & 4: return value when already ns object
+/******/ 		// mode & 16: return value when it's Promise-like
+/******/ 		// mode & 8|1: behave like require
+/******/ 		__webpack_require__.t = function(value, mode) {
+/******/ 			if(mode & 1) value = this(value);
+/******/ 			if(mode & 8) return value;
+/******/ 			if(typeof value === 'object' && value) {
+/******/ 				if((mode & 4) && value.__esModule) return value;
+/******/ 				if((mode & 16) && typeof value.then === 'function') return value;
+/******/ 			}
+/******/ 			var ns = Object.create(null);
+/******/ 			__webpack_require__.r(ns);
+/******/ 			var def = {};
+/******/ 			leafPrototypes = leafPrototypes || [null, getProto({}), getProto([]), getProto(getProto)];
+/******/ 			for(var current = mode & 2 && value; typeof current == 'object' && !~leafPrototypes.indexOf(current); current = getProto(current)) {
+/******/ 				Object.getOwnPropertyNames(current).forEach((key) => (def[key] = () => (value[key])));
+/******/ 			}
+/******/ 			def['default'] = () => (value);
+/******/ 			__webpack_require__.d(ns, def);
+/******/ 			return ns;
+/******/ 		};
+/******/ 	})();
+/******/ 	
 /******/ 	/* webpack/runtime/define property getters */
 /******/ 	(() => {
 /******/ 		// define getter functions for harmony exports
@@ -1054,7 +1084,11 @@ var ApiName;
     ApiName["Tasks_UpdateTask"] = "tasks.updateTask";
 })(ApiName || (ApiName = {}));
 
+;// CONCATENATED MODULE: ./src/artifactsForCDN/validDomains.json
+const validDomains_namespaceObject = JSON.parse('{"validOrigins":["teams.microsoft.com","teams.microsoft.us","gov.teams.microsoft.us","dod.teams.microsoft.us","int.teams.microsoft.com","teams.live.com","devspaces.skype.com","ssauth.skype.com","local.teams.live.com","local.teams.live.com:8080","local.teams.office.com","local.teams.office.com:8080","outlook.office.com","outlook-sdf.office.com","outlook.office365.com","outlook-sdf.office365.com","outlook.live.com","outlook-sdf.live.com","*.teams.microsoft.com","*.www.office.com","www.office.com","word.office.com","excel.office.com","powerpoint.office.com","www.officeppe.com","*.www.microsoft365.com","www.microsoft365.com","bing.com","edgeservices.bing.com","www.bing.com","www.staging-bing-int.com","teams.cloud.microsoft","outlook.cloud.microsoft","m365.cloud.microsoft","copilot.microsoft.com"]}');
+var artifactsForCDN_validDomains_namespaceObject = /*#__PURE__*/__webpack_require__.t(validDomains_namespaceObject, 2);
 ;// CONCATENATED MODULE: ./src/internal/constants.ts
+
 /**
  * @hidden
  * The client version when all SDK APIs started to check platform compatibility for the APIs was 1.6.0.
@@ -1155,48 +1189,28 @@ const getMediaCallbackSupportVersion = '2.0.0';
 const scanBarCodeAPIMobileSupportVersion = '1.9.0';
 /**
  * @hidden
- * List of supported Host origins
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const validOrigins = [
-    'teams.microsoft.com',
-    'teams.microsoft.us',
-    'gov.teams.microsoft.us',
-    'dod.teams.microsoft.us',
-    'int.teams.microsoft.com',
-    'teams.live.com',
-    'devspaces.skype.com',
-    'ssauth.skype.com',
-    'local.teams.live.com',
-    'local.teams.live.com:8080',
-    'local.teams.office.com',
-    'local.teams.office.com:8080',
-    'outlook.office.com',
-    'outlook-sdf.office.com',
-    'outlook.office365.com',
-    'outlook-sdf.office365.com',
-    'outlook.live.com',
-    'outlook-sdf.live.com',
-    '*.teams.microsoft.com',
-    '*.www.office.com',
-    'www.office.com',
-    'word.office.com',
-    'excel.office.com',
-    'powerpoint.office.com',
-    'www.officeppe.com',
-    '*.www.microsoft365.com',
-    'www.microsoft365.com',
-    'bing.com',
-    'edgeservices.bing.com',
-    'www.bing.com',
-    'www.staging-bing-int.com',
-    'teams.cloud.microsoft',
-    'outlook.cloud.microsoft',
-    'm365.cloud.microsoft',
-    'copilot.microsoft.com',
-];
+ * Fallback list of valid origins in JSON format
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const validOriginsLocal = artifactsForCDN_validDomains_namespaceObject;
+/**
+ * @hidden
+ * Fallback list of valid origins
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const validOriginsFallback = validOriginsLocal.validOrigins;
+/**
+ * @hidden
+ * CDN endpoint of the list of valid origins
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const validOriginsCdnEndpoint = new URL('https://res.cdn.office.net/teams-js/validDomains/json/validDomains.json');
 /**
  * @hidden
  * USer specified message origins should satisfy this test
@@ -1649,59 +1663,6 @@ const errorInvalidResponse = new Error('Invalid response: Received more images t
 /* eslint-disable @typescript-eslint/no-unused-vars */
 
 
-
-
-
-/**
- * @param pattern - reference pattern
- * @param host - candidate string
- * @returns returns true if host matches pre-know valid pattern
- *
- * @example
- *    validateHostAgainstPattern('*.teams.microsoft.com', 'subdomain.teams.microsoft.com') returns true
- *    validateHostAgainstPattern('teams.microsoft.com', 'team.microsoft.com') returns false
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-function validateHostAgainstPattern(pattern, host) {
-    if (pattern.substring(0, 2) === '*.') {
-        const suffix = pattern.substring(1);
-        if (host.length > suffix.length &&
-            host.split('.').length === suffix.split('.').length &&
-            host.substring(host.length - suffix.length) === suffix) {
-            return true;
-        }
-    }
-    else if (pattern === host) {
-        return true;
-    }
-    return false;
-}
-const validateOriginLogger = getLogger('validateOrigin');
-/**
- * @internal
- * Limited to Microsoft-internal use
- */
-function validateOrigin(messageOrigin) {
-    // Check whether the url is in the pre-known allowlist or supplied by user
-    if (!isValidHttpsURL(messageOrigin)) {
-        validateOriginLogger('Origin %s is invalid because it is not using https protocol. Protocol being used: %s', messageOrigin, messageOrigin.protocol);
-        return false;
-    }
-    const messageOriginHost = messageOrigin.host;
-    if (validOrigins.some((pattern) => validateHostAgainstPattern(pattern, messageOriginHost))) {
-        return true;
-    }
-    for (const domainOrPattern of GlobalVars.additionalValidOrigins) {
-        const pattern = domainOrPattern.substring(0, 8) === 'https://' ? domainOrPattern.substring(8) : domainOrPattern;
-        if (validateHostAgainstPattern(pattern, messageOriginHost)) {
-            return true;
-        }
-    }
-    validateOriginLogger('Origin %s is invalid because it is not an origin approved by this library or included in the call to app.initialize.\nOrigins approved by this library: %o\nOrigins included in app.initialize: %o', messageOrigin, validOrigins, GlobalVars.additionalValidOrigins);
-    return false;
-}
 /**
  * @internal
  * Limited to Microsoft-internal use
@@ -2262,7 +2223,13 @@ const mapTeamsVersionToSupportedCapabilities = {
     '2.0.5': [
         {
             capability: { webStorage: {} },
-            hostClientTypes: [HostClientType.android, HostClientType.desktop, HostClientType.ios],
+            hostClientTypes: [HostClientType.android, HostClientType.ios],
+        },
+    ],
+    '2.0.8': [
+        {
+            capability: { sharing: {} },
+            hostClientTypes: [HostClientType.android, HostClientType.ios],
         },
     ],
 };
@@ -2379,7 +2346,7 @@ const _minRuntimeConfigToUninitialize = {
  * @hidden
  *  Package version.
  */
-const version = "2.19.0-beta.2";
+const version = "2.19.0-beta.3";
 
 ;// CONCATENATED MODULE: ./src/internal/internalAPIs.ts
 
@@ -2515,6 +2482,137 @@ function isNullOrUndefined(value) {
     return value === null || value === undefined;
 }
 
+;// CONCATENATED MODULE: ./src/internal/validOrigins.ts
+var __awaiter = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+
+
+
+
+let validOriginsCache = [];
+const validateOriginLogger = getLogger('validateOrigin');
+function prefetchOriginsFromCDN() {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield getValidOriginsListFromCDN();
+    });
+}
+function isValidOriginsCacheEmpty() {
+    return validOriginsCache.length !== 0;
+}
+function getValidOriginsListFromCDN() {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (isValidOriginsCacheEmpty()) {
+            return validOriginsCache;
+        }
+        if (!inServerSideRenderingEnvironment()) {
+            return fetch(validOriginsCdnEndpoint)
+                .then((response) => {
+                if (!response.ok) {
+                    throw new Error('Invalid Response from Fetch Call');
+                }
+                return response.json().then((validOriginsCDN) => {
+                    if (isValidOriginsJSONValid(JSON.stringify(validOriginsCDN))) {
+                        validOriginsCache = validOriginsCDN.validOrigins;
+                        return validOriginsCache;
+                    }
+                    else {
+                        throw new Error('Valid Origins List Is Invalid');
+                    }
+                });
+            })
+                .catch((e) => {
+                validateOriginLogger('validOrigins fetch call to CDN failed with error: %s. Defaulting to fallback list', e);
+                validOriginsCache = validOriginsFallback;
+                return validOriginsCache;
+            });
+        }
+        else {
+            validOriginsCache = validOriginsFallback;
+            return validOriginsFallback;
+        }
+    });
+}
+function isValidOriginsJSONValid(validOriginsJSON) {
+    let validOriginsCDN = JSON.parse(validOriginsJSON);
+    try {
+        validOriginsCDN = JSON.parse(validOriginsJSON);
+    }
+    catch (_) {
+        return false;
+    }
+    if (!validOriginsCDN.validOrigins) {
+        return false;
+    }
+    for (const validOrigin of validOriginsCDN.validOrigins) {
+        try {
+            new URL('https://' + validOrigin);
+        }
+        catch (_) {
+            validateOriginLogger('isValidOriginsFromCDN call failed to validate origin: %s', validOrigin);
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * @param pattern - reference pattern
+ * @param host - candidate string
+ * @returns returns true if host matches pre-know valid pattern
+ *
+ * @example
+ *    validateHostAgainstPattern('*.teams.microsoft.com', 'subdomain.teams.microsoft.com') returns true
+ *    validateHostAgainstPattern('teams.microsoft.com', 'team.microsoft.com') returns false
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function validateHostAgainstPattern(pattern, host) {
+    if (pattern.substring(0, 2) === '*.') {
+        const suffix = pattern.substring(1);
+        if (host.length > suffix.length &&
+            host.split('.').length === suffix.split('.').length &&
+            host.substring(host.length - suffix.length) === suffix) {
+            return true;
+        }
+    }
+    else if (pattern === host) {
+        return true;
+    }
+    return false;
+}
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function validateOrigin(messageOrigin) {
+    return getValidOriginsListFromCDN().then((validOriginsList) => {
+        // Check whether the url is in the pre-known allowlist or supplied by user
+        if (!isValidHttpsURL(messageOrigin)) {
+            validateOriginLogger('Origin %s is invalid because it is not using https protocol. Protocol being used: %s', messageOrigin, messageOrigin.protocol);
+            return false;
+        }
+        const messageOriginHost = messageOrigin.host;
+        if (validOriginsList.some((pattern) => validateHostAgainstPattern(pattern, messageOriginHost))) {
+            return true;
+        }
+        for (const domainOrPattern of GlobalVars.additionalValidOrigins) {
+            const pattern = domainOrPattern.substring(0, 8) === 'https://' ? domainOrPattern.substring(8) : domainOrPattern;
+            if (validateHostAgainstPattern(pattern, messageOriginHost)) {
+                return true;
+            }
+        }
+        validateOriginLogger('Origin %s is invalid because it is not an origin approved by this library or included in the call to app.initialize.\nOrigins approved by this library: %o\nOrigins included in app.initialize: %o', messageOrigin, validOriginsList, GlobalVars.additionalValidOrigins);
+        return false;
+    });
+}
+
 ;// CONCATENATED MODULE: ./src/public/authentication.ts
 
 
@@ -3565,6 +3663,7 @@ var menus;
 
 
 
+
 /**
  * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
  */
@@ -3789,6 +3888,7 @@ var app;
      * @returns Promise that will be fulfilled when initialization has completed, or rejected if the initialization fails or times out
      */
     function initialize(validMessageOrigins) {
+        prefetchOriginsFromCDN();
         return appInitializeHelper(getApiVersionTag(appTelemetryVersionNumber, ApiName.App_Initialize), validMessageOrigins);
     }
     app.initialize = initialize;
@@ -5089,6 +5189,16 @@ function handlers_registerOnResumeHandler(handler) {
 /* eslint-disable @typescript-eslint/ban-types */
 /* eslint-disable @typescript-eslint/no-explicit-any */
 /* eslint-disable strict-null-checks/all */
+var communication_awaiter = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+
 
 
 
@@ -5120,7 +5230,7 @@ CommunicationPrivate.promiseCallbacks = {};
  */
 function initializeCommunication(validMessageOrigins, apiVersionTag) {
     // Listen for messages post to our window
-    CommunicationPrivate.messageListener = (evt) => processMessage(evt);
+    CommunicationPrivate.messageListener = (evt) => communication_awaiter(this, void 0, void 0, function* () { return yield processMessage(evt); });
     // If we are in an iframe, our parent window is the one hosting us (i.e., window.parent); otherwise,
     // it's the window that opened us (i.e., window.opener)
     Communication.currentWindow = Communication.currentWindow || ssrSafeWindow();
@@ -5404,29 +5514,33 @@ const processMessageLogger = communicationLogger.extend('processMessage');
  * Limited to Microsoft-internal use
  */
 function processMessage(evt) {
-    // Process only if we received a valid message
-    if (!evt || !evt.data || typeof evt.data !== 'object') {
-        processMessageLogger('Unrecognized message format received by app, message being ignored. Message: %o', evt);
-        return;
-    }
-    // Process only if the message is coming from a different window and a valid origin
-    // valid origins are either a pre-known origin or one specified by the app developer
-    // in their call to app.initialize
-    const messageSource = evt.source || (evt.originalEvent && evt.originalEvent.source);
-    const messageOrigin = evt.origin || (evt.originalEvent && evt.originalEvent.origin);
-    if (!shouldProcessMessage(messageSource, messageOrigin)) {
-        processMessageLogger('Message being ignored by app because it is either coming from the current window or a different window with an invalid origin');
-        return;
-    }
-    // Update our parent and child relationships based on this message
-    updateRelationships(messageSource, messageOrigin);
-    // Handle the message
-    if (messageSource === Communication.parentWindow) {
-        handleParentMessage(evt);
-    }
-    else if (messageSource === Communication.childWindow) {
-        handleChildMessage(evt);
-    }
+    return communication_awaiter(this, void 0, void 0, function* () {
+        // Process only if we received a valid message
+        if (!evt || !evt.data || typeof evt.data !== 'object') {
+            processMessageLogger('Unrecognized message format received by app, message being ignored. Message: %o', evt);
+            return;
+        }
+        // Process only if the message is coming from a different window and a valid origin
+        // valid origins are either a pre-known origin or one specified by the app developer
+        // in their call to app.initialize
+        const messageSource = evt.source || (evt.originalEvent && evt.originalEvent.source);
+        const messageOrigin = evt.origin || (evt.originalEvent && evt.originalEvent.origin);
+        return shouldProcessMessage(messageSource, messageOrigin).then((result) => {
+            if (!result) {
+                processMessageLogger('Message being ignored by app because it is either coming from the current window or a different window with an invalid origin');
+                return;
+            }
+            // Update our parent and child relationships based on this message
+            updateRelationships(messageSource, messageOrigin);
+            // Handle the message
+            if (messageSource === Communication.parentWindow) {
+                handleParentMessage(evt);
+            }
+            else if (messageSource === Communication.childWindow) {
+                handleChildMessage(evt);
+            }
+        });
+    });
 }
 const shouldProcessMessageLogger = communicationLogger.extend('shouldProcessMessage');
 /**
@@ -5437,25 +5551,27 @@ const shouldProcessMessageLogger = communicationLogger.extend('shouldProcessMess
  * Limited to Microsoft-internal use
  */
 function shouldProcessMessage(messageSource, messageOrigin) {
-    // Process if message source is a different window and if origin is either in
-    // Teams' pre-known whitelist or supplied as valid origin by user during initialization
-    if (Communication.currentWindow && messageSource === Communication.currentWindow) {
-        shouldProcessMessageLogger('Should not process message because it is coming from the current window');
-        return false;
-    }
-    else if (Communication.currentWindow &&
-        Communication.currentWindow.location &&
-        messageOrigin &&
-        messageOrigin === Communication.currentWindow.location.origin) {
-        return true;
-    }
-    else {
-        const isOriginValid = validateOrigin(new URL(messageOrigin));
-        if (!isOriginValid) {
-            shouldProcessMessageLogger('Message has an invalid origin of %s', messageOrigin);
+    return communication_awaiter(this, void 0, void 0, function* () {
+        // Process if message source is a different window and if origin is either in
+        // Teams' pre-known whitelist or supplied as valid origin by user during initialization
+        if (Communication.currentWindow && messageSource === Communication.currentWindow) {
+            shouldProcessMessageLogger('Should not process message because it is coming from the current window');
+            return false;
         }
-        return isOriginValid;
-    }
+        else if (Communication.currentWindow &&
+            Communication.currentWindow.location &&
+            messageOrigin &&
+            messageOrigin === Communication.currentWindow.location.origin) {
+            return true;
+        }
+        else {
+            const isOriginValid = yield validateOrigin(new URL(messageOrigin));
+            if (!isOriginValid) {
+                shouldProcessMessageLogger('Message has an invalid origin of %s', messageOrigin);
+            }
+            return isOriginValid;
+        }
+    });
 }
 /**
  * @internal
@@ -7061,7 +7177,7 @@ var chat;
 })(chat || (chat = {}));
 
 ;// CONCATENATED MODULE: ./src/public/clipboard.ts
-var __awaiter = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
+var clipboard_awaiter = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
         function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
@@ -7101,7 +7217,7 @@ var clipboard;
      *          rejects with error stating the reason for failure.
      */
     function write(blob) {
-        return __awaiter(this, void 0, void 0, function* () {
+        return clipboard_awaiter(this, void 0, void 0, function* () {
             internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.content, FrameContexts.meetingStage, FrameContexts.task, FrameContexts.settings, FrameContexts.stage, FrameContexts.sidePanel);
             if (!isSupported()) {
                 throw errorNotSupportedOnPlatform;
@@ -7126,7 +7242,7 @@ var clipboard;
      *          Note: Returned blob type will contain one of the MIME type `image/png`, `text/plain` or `text/html`.
      */
     function read() {
-        return __awaiter(this, void 0, void 0, function* () {
+        return clipboard_awaiter(this, void 0, void 0, function* () {
             internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.content, FrameContexts.meetingStage, FrameContexts.task, FrameContexts.settings, FrameContexts.stage, FrameContexts.sidePanel);
             if (!isSupported()) {
                 throw errorNotSupportedOnPlatform;
@@ -8413,7 +8529,7 @@ var teamsCore;
     /**
      * Registers a handler to be called when the page has been requested to load.
      *
-     * @remarks Check out [App Caching in Teams](https://learn.microsoft.com/microsoftteams/platform/apps-in-teams-meetings/build-tabs-for-meeting?tabs=desktop%2Cmeeting-chat-view-desktop%2Cmeeting-stage-view-desktop%2Cchannel-meeting-desktop#app-caching)
+     * @remarks Check out [App Caching in Teams](https://learn.microsoft.com/en-us/microsoftteams/platform/tabs/how-to/app-caching)
      * for a more detailed explanation about using this API.
      *
      * @param handler - The handler to invoke when the page is loaded.
@@ -8452,7 +8568,7 @@ var teamsCore;
     /**
      * Registers a handler to be called before the page is unloaded.
      *
-     * @remarks Check out [App Caching in Teams](https://learn.microsoft.com/microsoftteams/platform/apps-in-teams-meetings/build-tabs-for-meeting?tabs=desktop%2Cmeeting-chat-view-desktop%2Cmeeting-stage-view-desktop%2Cchannel-meeting-desktop#app-caching)
+     * @remarks Check out [App Caching in Teams](https://learn.microsoft.com/en-us/microsoftteams/platform/tabs/how-to/app-caching)
      * for a more detailed explanation about using this API.
      *
      * @param handler - The handler to invoke before the page is unloaded. If this handler returns true the page should