@sapui5/sap.ushell 1.120.7 → 1.121.0

package/src/main/js/sap/ushell/services/Menu.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The menu service provides the entries for the menu bar
- * @version 1.120.7
+ * @version 1.121.0
  */
 sap.ui.define([
     "sap/ushell/Config",
@@ -33,7 +33,7 @@ sap.ui.define([
      *
      * <b>Note:</b> To retrieve a valid instance of this service, it is necessary to call
      * <code>sap.ushell.Container.getServiceAsync("Menu")</code>. For details, see
-     * {@link sap.ushell.services.Container#getServiceAsync}.
+     * {@link sap.ushell.Container#getServiceAsync}.
      *
      * @hideconstructor
      *
@@ -140,7 +140,7 @@ sap.ui.define([
      *    An entry in the space-pages-hierarchy which briefly describes a space and its pages
      * @property {string} title Text of the space
      * @property {string} id ID of the space
-     * @property {array} pages
+     * @property {Array<{ title: string, id: string }>} pages
      *    Contains an array of pages which contribute to the space
      */
 

package/src/main/js/sap/ushell/services/Message.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The Unified Shell's message service.
- * @version 1.120.7
+ * @version 1.121.0
  */
 sap.ui.define([
     "sap/base/Log",
@@ -52,8 +52,9 @@ sap.ui.define([
      *
      * <b>Note:</b> To retrieve a valid instance of this service, it is necessary to call
      * <code>sap.ushell.Container.getServiceAsync("Message")</code>. For details, see
-     * {@link sap.ushell.services.Container#getServiceAsync}.
+     * {@link sap.ushell.Container#getServiceAsync}.
      *
+     * @augments sap.ushell.services.Service
      * @hideconstructor
      *
      * @since 1.16.0
@@ -69,7 +70,8 @@ sap.ui.define([
          * The signature of the callback is defined via the show function.
          *
          * @param {function} fnShellCallback callback for the shell to execute showing the message
-         * @returns {sap.ushell.services.Message} The MessageService
+         * @returns {this} <code>this</code> for method chaining
+         *
          * @private
          */
         this.init = function (fnShellCallback) {
@@ -84,6 +86,7 @@ sap.ui.define([
          * @param {sap.ushell.services.Message.Type} iType message type
          * @param {string} sMessage the localized message as plain text
          * @param {object} oParameters Some parameters
+         *
          * @private
          */
         this.show = function (iType, sMessage, oParameters) {
@@ -105,6 +108,7 @@ sap.ui.define([
          * @param {int} iType message type
          * @param {string} sMessage message text
          * @param {object} oParameters message parameters
+         *
          * @private
          */
         this.buildMessage = function (iType, sMessage, oParameters) {
@@ -152,6 +156,7 @@ sap.ui.define([
          * @param {string} message The message displayed by the dialog.
          * @param {object} config The configuration of the dialog.
          * @param {string} dialogTitle The title of the dialog.
+         *
          * @private
          */
         this._copyToClipboard = function (message, config, dialogTitle) {
@@ -205,6 +210,7 @@ sap.ui.define([
          *
          * @param {string} message message text
          * @param {object} messageConfig message configuration (title and details)
+         *
          * @private
          */
         this._createAndOpenErrorDialog = function (message, messageConfig) {
@@ -264,6 +270,7 @@ sap.ui.define([
          *
          * @param {string} sMessage The message
          * @param {int} iDuration The duration of the MessageToast in ms
+         *
          * @private
          */
         this.buildAndSendMessageToast = function (sMessage, iDuration) {
@@ -278,6 +285,7 @@ sap.ui.define([
          * @param {string} sMessage The actual error message
          * @param {string} sType The type of the MessageBox. e.g.: show, confirm
          * @param {object} oConfig The configuration of the MessageBox
+         *
          * @private
          */
         this.sendMessageBox = function (sMessage, sType, oConfig) {
@@ -293,9 +301,9 @@ sap.ui.define([
          *
          * @param {string} sMessage the localized message as plain text
          * @param {int} [iDuration=3000] display duration in ms
+         *
          * @since 1.16.0
          * @public
-         * @alias sap.ushell.services.Message#info
          */
         this.info = function (sMessage, iDuration) {
             this.show(Message.Type.INFO, sMessage, { duration: iDuration || 3000 });
@@ -306,9 +314,9 @@ sap.ui.define([
          *
          * @param {string} sMessage the localized message as plain text
          * @param {string} [sTitle] the localized title as plain text
+         *
          * @since 1.16.0
          * @public
-         * @alias sap.ushell.services.Message#error
          */
         this.error = function (sMessage, sTitle) {
             Log.error(sMessage);
@@ -337,10 +345,9 @@ sap.ui.define([
          *   If more than two actions are given, only the first two actions are taken.
          *   Custom action string(s) can be provided, and then the translation of custom action string(s)
          *   needs to be done by the application.
+         *
          * @since 1.16.0
          * @public
-         *
-         * @alias sap.ushell.services.Message#confirm
          */
         this.confirm = function (sMessage, fnCallback, sTitle, vActions) {
             this.show(Message.Type.CONFIRM, sMessage, { title: sTitle, callback: fnCallback, actions: vActions });
@@ -359,9 +366,9 @@ sap.ui.define([
          * @param {sap.m.Button[]} [buttons] The custom buttons that should be shown on the dialog
          *
          * @returns {sap.m.Dialog} The error dialog, so it can be destroyed by a custom button
+         *
          * @since 1.81.0
          * @protected
-         * @alias sap.ushell.services.Message#errorWithDetails
          */
         this.errorWithDetails = function (message, detailControl, title, buttons) {
             if (Array.isArray(detailControl)) {
@@ -426,7 +433,7 @@ sap.ui.define([
     }
 
     /**
-     * @name sap.ushell.services.Message.Type
+     * @alias sap.ushell.services.Message.Type
      * @since 1.16.0
      * @private
      */

package/src/main/js/sap/ushell/services/MessageBroker.js

@@ -1,8 +1,8 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
 /**
- * @fileOverview This module exposes API enpoints for Generic Communication
- * @version 1.120.7
+ * @fileOverview This module exposes API endpoints for Generic Communication
+ * @version 1.121.0
  */
 sap.ui.define([
     "sap/ushell/services/_MessageBroker/MessageBrokerEngine",
@@ -19,7 +19,7 @@ sap.ui.define([
      *
      * <b>Note:</b> To retrieve a valid instance of this service, it is necessary to call
      * <code>sap.ushell.Container.getServiceAsync("MessageBroker")</code>. For details, see
-     * {@link sap.ushell.services.Container#getServiceAsync}.
+     * {@link sap.ushell.Container#getServiceAsync}.
      *
      * @hideconstructor
      *
@@ -70,7 +70,7 @@ sap.ui.define([
     /**
      *
      * @param {string} sClientId client id.
-     * @param {array} aSubscribedChannels array of channel-objects.
+     * @param {Array<*>} aSubscribedChannels array of channel-objects.
      * @param {function} fnMessageCallback callback function returns promise.
      * @param {function} fnClientConnectionCallback callback function returns promise.
      * @returns {Promise} Promise result.
@@ -96,7 +96,7 @@ sap.ui.define([
     /**
      *
      * @param {string} sClientId client ID.
-     * @param {array} aUnsubscribedChannels channels to unsubscribe from.
+     * @param {Array<*>} aUnsubscribedChannels channels to unsubscribe from.
      * @returns {Promise} Promise result.
      *
      * @since 1.110.0
@@ -113,7 +113,7 @@ sap.ui.define([
      * @param {string} sClientId client Id.
      * @param {string} sMessageId message Id.
      * @param {string} sMessageName message name.
-     * @param {array} aTargetClientIds array of target clients Ids.
+     * @param {Array<*>} aTargetClientIds array of target clients Ids.
      * @param {object} data additional data.
      * @returns {Promise} Promise result.
      *

package/src/main/js/sap/ushell/services/NavTargetResolution.js

@@ -37,7 +37,7 @@ sap.ui.define([
      *
      * <b>Note:</b> To retrieve a valid instance of this service, it is necessary to call
      * <code>sap.ushell.Container.getServiceAsync("NavTargetResolution")</code>. For details, see
-     * {@link sap.ushell.services.Container#getServiceAsync}.
+     * {@link sap.ushell.Container#getServiceAsync}.
      *
      * Methods in this class deal with *internal* representations of the shell hash.
      *
@@ -51,6 +51,7 @@ sap.ui.define([
      * @param {string} sParameters not used
      * @param {object} oServiceConfiguration oServiceConfiguration
      *
+     * @augments sap.ushell.services.Service
      * @hideconstructor
      *
      * @since 1.15.0
@@ -98,7 +99,7 @@ sap.ui.define([
          * Resolves shell hash fragment via ClientSideTargetResolution service.
          *
          * @param {string} sHashFragment the hash fragment to be resolved
-         * @returns {jQuery.Deferred.Promise} a jQuery promise resolved with the resolution result object.
+         * @returns {jQuery.Promise} Resolves the resolution result object.
          * @private
          * @since 1.34.0
          */
@@ -117,7 +118,7 @@ sap.ui.define([
          * and fixes any "SAPUI5" applicationType returned in the response to "URL", to avoid backward compatibility problems.
          *
          * @param {string} sFragmentNoHash the hash fragment to resolve
-         * @returns {jQuery.Promise} A jQuery Promise that resolves to an object representing the resolution result
+         * @returns {jQuery.Promise} Resolves to an object representing the resolution result
          * @private
          * @since 1.34.0
          */
@@ -189,9 +190,9 @@ sap.ui.define([
          *
          * @param {string} sHashFragment The formatted URL hash fragment in internal format
          *   (as obtained by the SAPUI5 hasher service, not as given in <code>location.hash</code>)
-         * @returns {string} A jQuery.Promise. Its <code>done()</code> function gets an expanded shell hash (in internal format)
+         * @returns {jQuery.Promise} Resolves expanded shell hash (in internal format).
+         *
          * @public
-         * @alias sap.ushell.services.NavTargetResolution#expandCompactHash
          */
         this.expandCompactHash = function (sHashFragment) {
             var oDeferred = new jQuery.Deferred();
@@ -317,7 +318,7 @@ sap.ui.define([
          *     }
          *   }
          * </pre>
-         * @returns {jQuery.Promise} A jQuery.Promise. Its <code>done()</code> function gets an object. Typically it contains the following information:
+         * @returns {jQuery.Promise} Resolves an object. Typically it contains the following information:
          *   <pre>
          *   {
          *     "url": "/sap/bc/",
@@ -325,8 +326,8 @@ sap.ui.define([
          *     "externalNavigationMode": boolean
          *   }
          *   </pre>
+         *
          * @protected
-         * @alias sap.ushell.services.NavTargetResolution#resolveTarget
          */
         this.resolveTarget = function (oArgs) {
             var sHashFragment;
@@ -378,7 +379,7 @@ sap.ui.define([
          *
          * @param {string} sHashFragment The formatted URL hash fragment in internal format (as obtained by the SAPUI5 hasher service) not as given in <code>location.hash</code>)!
          *   Example: <code>#SemanticObject-action?P1=V1&P2=A%20B%20C</code>
-         * @returns {object} A jQuery.Promise. Its <code>done()</code> function gets an object that you can use to create a {@link sap.ushell.components.container.ApplicationContainer}
+         * @returns {jQuery.Promise} Resolves an object that you can use to create a {@link sap.ushell.components.container.ApplicationContainer}
          *   or <code>undefined</code> in case the hash fragment was empty. Typically it contains the following information:
          *   <pre>
          *   {
@@ -394,9 +395,8 @@ sap.ui.define([
          *   It is added to the result using the logic in {@link navigationMode#getNavigationMode} if none of the resolvers in the chain added it.
          *   </p>
          *   <p>No navigation should occur when the promise is resolved to <code>undefined</code>.</p>
-         * @public
          *
-         * @alias sap.ushell.services.NavTargetResolution#resolveHashFragment
+         * @public
          */
         this.resolveHashFragment = function (sHashFragment) {
             var oDeferred = new jQuery.Deferred();
@@ -574,7 +574,7 @@ sap.ui.define([
          *   Also, wildcards for semanticObject and action parameters are now expressed via <code>undefined</code>,
          *   or by just omitting the parameter in the object.
          *   </p>
-         * @returns {jQuery.Promise} A jQuery Promise that resolves with an array of links objects containing (at least) the following properties:
+         * @returns {jQuery.Promise} Resolves with an array of links objects containing (at least) the following properties:
          *   <pre>
          *   {
          *     intent: "#AnObject-Action?A=B&C=e&C=j",
@@ -649,9 +649,9 @@ sap.ui.define([
                         params: oParameters
                     };
 
-                    sap.ushell.Container.getServiceAsync("ShellNavigation")
-                        .then(function (ShellNavigationService) {
-                            ShellNavigationService.hrefForExternal(oHrefForExternalArg, true, oComponent)
+                    sap.ushell.Container.getServiceAsync("ShellNavigationInternal")
+                        .then(function (oShellNavigationInternal) {
+                            oShellNavigationInternal.hrefForExternal(oHrefForExternalArg, true, oComponent)
                                 .then(function (oResVerboseCompacted) {
                                     // may contain sap-intent-param (but server does nothing with it)
                                     var oMaybeCompactedParameters = oResVerboseCompacted.params || oParameters;
@@ -681,7 +681,7 @@ sap.ui.define([
          * Returns a list of unique semantic objects assigned to the current user.
          * Tries to use client side target resolution if it is enabled, falls back to the NavTargetResolution adapter implementation otherwise.
          *
-         * @returns {jQuery.Promise} A jQuery Promise that resolves with an array of strings
+         * @returns {jQuery.Promise} Resolves with an array of strings
          *   representing the User's semantic objects or rejects with an error message.
          *   <p>NOTE: semantic objects are returned in lexicographical order in the result array.</p>
          * @private
@@ -760,9 +760,9 @@ sap.ui.define([
         /**
          * Shortens all URLs found in the result of getSemanticObjectLinks.
          *
-         * @param {array} aGetSemanticObjectLinksResults the result of {@link #getSemanticObjectLinks}
+         * @param {object[]} aGetSemanticObjectLinksResults the result of {@link #getSemanticObjectLinks}
          * @param {object} oComponent a SAPUI5 component. The same passed to getSemanticObjectLinks}.
-         * @returns {jQuery.Promise} A jQuery Promise that is guaranteed to resolve to an array with the same
+         * @returns {jQuery.Promise} Always resolves to an array with the same
          *   structure as the array returned from getSemanticObjectLinks, but with shortened intents.
          *   NOTE: if it's not possible to shorten an intent in the input array, a warning is logged on the console and the entire intent is kept.
          * @private
@@ -774,11 +774,11 @@ sap.ui.define([
             var iPromisesToResolve = aGetSemanticObjectLinksResults.length;
             var oDeferred = new jQuery.Deferred();
 
-            sap.ushell.Container.getServiceAsync("ShellNavigation")
-                .then(function (ShellNavigationService) {
+            sap.ushell.Container.getServiceAsync("ShellNavigationInternal")
+                .then(function (oShellNavigationInternal) {
                     aGetSemanticObjectLinksResults.forEach(function (oIntent) {
                         var oUrlParts = UrlParsing.parseShellHash(oIntent.intent);
-                        var oCompactParamsPromise = ShellNavigationService.compactParams(oUrlParts.params, undefined, oComponent);
+                        var oCompactParamsPromise = oShellNavigationInternal.compactParams(oUrlParts.params, undefined, oComponent);
 
                         aSemanticObjectLinksShortened.push(oCompactParamsPromise);
 
@@ -822,8 +822,7 @@ sap.ui.define([
          *
          * @param {string[]} aIntents the intents (such as <code>"#AnObject-action?A=B&C=e&C=j"</code>) to be checked.
          *   The intents must be in internal format and expanded.
-         * @returns {jQuery.Promise} A jQuery Promise which is resolved with a map
-         *   containing the intents from <code>aIntents</code> as keys.
+         * @returns {jQuery.Promise} Resolves with a map containing the intents from <code>aIntents</code> as keys.
          *   The map values are objects with a property <code>supported</code> of type <code>boolean</code>.<br/>
          *   Example:
          *   <pre>
@@ -870,8 +869,7 @@ sap.ui.define([
          *
          * @param {string[]} aIntents the intents (such as <code>"#AnObject-action?A=B&C=e&C=j"</code>) to be checked.
          *   The intents must be in internal format and expanded.
-         * @returns {jQuery.Promise} A jQuery Promise which is resolved with a map
-         *   containing the intents from <code>aIntents</code> as keys.
+         * @returns {jQuery.Promise} Resolves with a map containing the intents from <code>aIntents</code> as keys.
          *   The map values are objects with a property <code>supported</code> of type <code>boolean</code>.<br/>
          *   Example:
          *   <pre>
@@ -937,8 +935,7 @@ sap.ui.define([
          * </pre>
          *   or
          *   <code>{ target : { shellHash : "AnObject-action?A=B&c=e" } }</code>
-         * @returns {object} A <code>jQuery.Deferred</code> object's promise which is resolved with an array (!) of
-         *   objects representing whether the intent is supported or not objects with a property <code>supported</code> of type <code>boolean</code>.<br/>
+         * @returns {jQuery.Promise} Resolves an array of objects representing whether the intent is supported or not objects with a property <code>supported</code> of type <code>boolean</code>.<br/>
          *   Example:
          *
          *   aIntents:
@@ -993,7 +990,6 @@ sap.ui.define([
          *
          * @since 1.32
          * @public
-         * @alias sap.ushell.services.NavTargetResolution#isNavigationSupported
          */
         this.isNavigationSupported = function (aIntents) {
             var oDeferred = new jQuery.Deferred();
@@ -1121,7 +1117,8 @@ sap.ui.define([
             });
         }
 
-        /* Register one fixed sample resolver for local resolution (portal use case)
+        /*
+         * Register one fixed sample resolver for local resolution (portal use case)
          *     #Test-local1 => local storage key  "sap.ushell#Test-local1"
          *     #Test-local2 => local storage key  "sap.ushell#Test-local1"
          *     #Test-url => sap-ushell-test-local1 , sap-ushell-test-url1-additionalInformation

package/src/main/js/sap/ushell/services/Navigation/utils.js

@@ -2,7 +2,7 @@
 /**
  * @fileOverview Navigation utility functions
  *
- * @version 1.120.7
+ * @version 1.121.0
  */
 
 

package/src/main/js/sap/ushell/services/Navigation.js

@@ -5,7 +5,7 @@
  * This file exposes an API to perform (invoke) Navigation for applications.
  * It exposes interfaces to perform a hash change and trigger a navigation.
  *
- * @version 1.120.7
+ * @version 1.121.0
  */
 sap.ui.define([
     "sap/base/Log",
@@ -55,7 +55,7 @@ sap.ui.define([
      *
      * <b>Note:</b> To retrieve a valid instance of this service, it is necessary to call
      * <code>sap.ushell.Container.getServiceAsync("Navigation")</code>. For details, see
-     * {@link sap.ushell.services.Container#getServiceAsync}.
+     * {@link sap.ushell.Container#getServiceAsync}.
      *
      * The Navigation service currently provides platform independent functionality.
      *
@@ -104,6 +104,7 @@ sap.ui.define([
      * @param {string} sParameters The parameters.
      * @param {object} oServiceConf Service Configuration.
      *
+     * @augments sap.ushell.services.Service
      * @hideconstructor
      *
      * @since 1.120.0
@@ -537,9 +538,9 @@ sap.ui.define([
                 oArgsClone = this._amendTargetWithSapUshellEncTestParameter(oArgsClone);
                 oArgsClone = this._injectInnerAppRoute(oArgsClone, innerAppRoute);
 
-                const ShellNavigation = await Container.getServiceAsync("ShellNavigation");
+                const ShellNavigationInternal = await Container.getServiceAsync("ShellNavigationInternal");
 
-                return ShellNavigation.hrefForExternal(oArgsClone, undefined, oComponent);
+                return ShellNavigationInternal.hrefForExternal(oArgsClone, undefined, oComponent);
             } catch (oError) {
                 Log.error("href could not be calculated", oError, "sap.ushell.services.Navigation");
             }
@@ -607,10 +608,10 @@ sap.ui.define([
          */
         this.isInitialNavigation = async function () {
             try {
-                const ShellNavigation = await Container.getServiceAsync("ShellNavigation");
-                const bIsInitialNavigation = ShellNavigation.isInitialNavigation();
+                const ShellNavigationInternal = await Container.getServiceAsync("ShellNavigationInternal");
+                const bIsInitialNavigation = ShellNavigationInternal.isInitialNavigation();
 
-                // An undefined value indicates that the ShellNavigation service did not initialize the ShellNavigationHashChanger yet.
+                // An undefined value indicates that the ShellNavigationInternal service did not initialize the ShellNavigationHashChanger yet.
                 // Hence this is the first navigation in case asked at this point in time.
                 if (typeof bIsInitialNavigation === "undefined") {
                     return true;
@@ -618,7 +619,7 @@ sap.ui.define([
 
                 return bIsInitialNavigation;
             } catch (oError) {
-                Log.debug("ShellNavigation service not available", "This will be treated as the initial navigation", "sap.ushell.services.Navigation");
+                Log.debug("ShellNavigationInternal service not available", "This will be treated as the initial navigation", "sap.ushell.services.Navigation");
                 return true;
             }
         };
@@ -662,7 +663,7 @@ sap.ui.define([
                 const { intent, innerAppRoute } = this._extractInnerAppRoute(oArgsClone);
 
                 const AppLifeCycle = await Container.getServiceAsync("AppLifeCycle");
-                const ShellNavigation = await Container.getServiceAsync("ShellNavigation");
+                const ShellNavigationInternal = await Container.getServiceAsync("ShellNavigationInternal");
 
                 const oCurrentApplication = AppLifeCycle.getCurrentApplication();
                 const oIntent = await (oCurrentApplication && oCurrentApplication.getIntent());
@@ -670,7 +671,7 @@ sap.ui.define([
                 // clone again because _extractInnerAppRoute might already changed the original structure
                 /**@type {sap.ushell.services.Navigation.Target} */
                 const oNavTarget = deepClone(oTarget);
-                this._checkIfAppNeedsToBeReloaded(oNavTarget, oCurrentApplication, oIntent, ShellNavigation.hashChanger);
+                this._checkIfAppNeedsToBeReloaded(oNavTarget, oCurrentApplication, oIntent, ShellNavigationInternal.hashChanger);
                 await navigationUtils.addXAppStateFromParameter(intent, "sap-xapp-state-data" /* parameter containing data */);
 
                 oArgsClone = this._getTargetWithCurrentSystem(intent, oComponent);
@@ -686,7 +687,7 @@ sap.ui.define([
 
                 oArgsClone = this._injectInnerAppRoute(oArgsClone, innerAppRoute);
 
-                await ShellNavigation.toExternal(oArgsClone, oComponent, bWriteHistory);
+                await ShellNavigationInternal.toExternal(oArgsClone, oComponent, bWriteHistory);
             } catch (oError) {
                 Log.error("Navigation.navigate failed", oError, "sap.ushell.services.Navigation");
             }
@@ -935,7 +936,7 @@ sap.ui.define([
          *
          * @param {sap.ushell.services.Navigation.Target[]} aTargets A list of navigation targets to be checked.
          * @param {sap.ui.core.Component} [oComponent] The root component of the application.
-         * @returns {Promise<{ supported: boolean }[]>} A promise that resolves to an array of objects indicating
+         * @returns {Promise<Array<{ supported: boolean }>>} A promise that resolves to an array of objects indicating
          *                                              whether the intent is supported or not. Each object has a
          *                                              property <code>supported</code> of type <code>boolean</code>.
          *
@@ -1156,7 +1157,7 @@ sap.ui.define([
          * @ui5-restricted SAP-internally public, must not be changed. Not part of public documentation.
          */
         this.createEmptyAppState = async function (oAppComponent, bTransientEnforced, sPersistencyMethod, oPersistencySettings) {
-            if (!BaseObject.isA(oAppComponent, "sap.ui.core.UIComponent")) {
+            if (!BaseObject.isObjectA(oAppComponent, "sap.ui.core.UIComponent")) {
                 return Promise.reject("The passed oAppComponent must be a UI5 Component.");
             }
 
@@ -1169,7 +1170,7 @@ sap.ui.define([
          * Get the app state object that was used for the current navigation
          *
          * @param {sap.ui.core.Component} oAppComponent - UI5 component, key will be extracted from component data.
-         * @returns {Promise<object>} promise resolving the app state object.
+         * @returns {Promise<object>} Resolves the app state object.
          *                            Note that this is an unmodifiable container and its data must be copied into a writable container!
          * @since 1.120.0
          * @private
@@ -1191,7 +1192,7 @@ sap.ui.define([
          * @private
          */
         this._checkComponent = function (oAppComponent) {
-            if (!BaseObject.isA(oAppComponent, "sap.ui.core.UIComponent")) {
+            if (!BaseObject.isObjectA(oAppComponent, "sap.ui.core.UIComponent")) {
                 throw new Error("oComponent passed must be a UI5 Component");
             }
         };
@@ -1202,7 +1203,7 @@ sap.ui.define([
          *
          * @param {sap.ui.core.Component} oAppComponent UI5 component, key will be extracted from component data
          * @param {object} sAppStateKey the application state key.
-         * @returns {Promise<object>} promise resolving the app state object.
+         * @returns {Promise<object>} Resolves the app state object.
          *                    <b>Note:</b> that this is an unmodifiable container and its data must be copied into a writable container!
          *
          * @since 1.120.0

package/src/main/js/sap/ushell/services/NavigationDataProvider.js

@@ -8,7 +8,7 @@
  *
  * Configured with the ClientSideTargetResolutionAdapter.
  *
- * @version 1.120.7
+ * @version 1.121.0
  */
 sap.ui.define([
     "sap/ushell/resources"
@@ -22,7 +22,7 @@ sap.ui.define([
      *
      * <b>Note:</b> To retrieve a valid instance of this service, it is necessary to call
      * <code>sap.ushell.Container.getServiceAsync("NavigationDataProvider")</code>. For details, see
-     * {@link sap.ushell.services.Container#getServiceAsync}.
+     * {@link sap.ushell.Container#getServiceAsync}.
      *
      * @hideconstructor
      *