Issue
After updating to Pega Platform 24.1.3, 24.2.2 or 25.1 users encounter JavaScript errors and UI regressions affecting UI focus and navigation.
Symptoms and Impact
Users experience any of the below symptoms when navigating between cases:
- JavaScript errors in the browser console
- Type Error: menuName.indexOf is not a function.
- Type Error: Cannot read properties of undefined (reading ‘length’).
- Blank Case Preview panels
-
Tabs failing to load after navigation
-
UI freeze during case preview interaction
-
Broken focus handling across menus and UI components
-
Inconsistent or unstable user navigation experience
Steps to Reproduce
-
Log in to the Portal in which you process Cases.
-
Navigate between cases.
-
Select a tab and open a case panel. This triggers JavaScript errors and UI failures. The javaScript errors prevent any further calls from client to server, and the user is presented with a busy indicator/throbber.
Root Cause
The issue is caused by the Dynamic System Setting (DSS) enableLabelBasedActiveMenuState, a feature intended to improve menu state handling which was introduced in Pega Platform releases 24.1.3, 24.2.2 and 25.1.
For details explaining the purpose of the DSS, see the Default dynamic system settings documentation.
When this setting is set to true, the runtime menu state logic evaluates a condition that can lead to JavaScript errors during UI interactions, including submenu/click-driven actions.
The active menu item stored in local storage contains tab label text instead of id, causing undefined length errors in pzPega_control_menu.js.
The logic validates only the length of the stored value, not its content, leading to UI failures when the stored value is invalid.
Solution
This DSS was added for specific use cases. If the application does not use dynamic rendering of case tabs, then the DSS can be set to false to avoid the problems.
This issue is planned to be addressed in a future Pega Platform release.
The specific release for the fix has not yet been determined. This section will be updated with release details when the fix for this issue is available.
References
Other default dynamic system settings