@globisnv/cypress-core 2.0.0 → 2.1.1

package/dist/commands/GLO_commands.d.ts

@@ -150,6 +150,20 @@ declare global {
              * @example - cy.GLO_clickDatacontrolViewerButton('salesorder', 'btnAdd');
              */
             GLO_clickDatacontrolViewerButton(pageName: string, buttonName: baseDatacontrolViewerButtonType, skipCheck?: skipCheckFlag): void;
+            /**
+             * Command to check the counter badges of a button within the main program datacontrol bar.
+             *
+             * The grey badge counts the attachments with a physical file or the closed notifications, the red badge the
+             * attachments without a physical file or the open notifications. A badge is hidden at 0, so passing 0 checks that it does not exist.
+             *
+             * @param {datacontrolCounterButtonType} buttonName - The datacontrol button with the counters.
+             * @param {number} greyCount - The expected grey count, 0 when there should be no grey badge.
+             * @param {number} redCount - The expected red count, 0 when there should be no red badge.
+             * @param {number} [timeOut = defaultTimeout] - The time to wait for the counters to update.
+             *
+             * @example - cy.GLO_checkDatacontrolCounter('btnAttachment', 3, 1);
+             */
+            GLO_checkDatacontrolCounter(buttonName: datacontrolCounterButtonType, greyCount: number, redCount: number, timeOut?: number): void;
             /**
              * Command to click a button based on its displayed text.
              *
@@ -193,16 +207,16 @@ declare global {
             /**
              * Command to open the workflow menu and to click a desired workflow in the main program datacontrol section.
              *
-             * @param {string} buttonName - The workflow entry to be selected.
-             * @param {exactMatchFlag} [exactMatch] - Indicates whether to search for an exact match (equalBool) or not. Default is disabled.
+             * @param {string} buttonName - The workflow entry to be selected. An entry with exactly this text is preferred over entries that only contain it.
+             * @param {exactMatchFlag} [exactMatch] - Only accept an exact match (equalBool). Default: disabled, falls back to the first entry containing the text when no entry matches exactly.
              */
             GLO_selectMenuButton(buttonName: string, exactMatch?: exactMatchFlag): void;
             /**
              * Command to open the workflow menu and to click a desired workflow in the datacontrol viewer section.
              *
              * @param {string} tabName - The name of the tab containing the datacontrol viewer section.
-             * @param {string} buttonName - The workflow entry to be selected.
-             * @param {exactMatchFlag} [exactMatch] - Indicates whether to search for an exact match (equalBool) or not). Default: is disabled.
+             * @param {string} buttonName - The workflow entry to be selected. An entry with exactly this text is preferred over entries that only contain it.
+             * @param {exactMatchFlag} [exactMatch] - Only accept an exact match (equalBool). Default: disabled, falls back to the first entry containing the text when no entry matches exactly.
              *
              * @example - cy.GLO_selectMenuButtonControlView('salesorder', 'Confirm');
              */

package/dist/commands/GLO_commands.js

@@ -472,6 +472,17 @@ Cypress.Commands.add('GLO_clickDatacontrolViewerButton', (pageName, buttonName,
             cy.GLO_getElement([`ng$${pageName}_tab`, 'datacontrol_viewer']).find('[title="Save record"][disabled="true"]', { timeout: 60000 });
     });
 });
+Cypress.Commands.add('GLO_checkDatacontrolCounter', (buttonName, greyCount, redCount, timeOut = defaultTimeout) => {
+    const button = () => cy.get(`globiscomponents-data-control[name="datacontrol"]:visible [id="${buttonName}"]`, { timeout: timeOut });
+    button().should('exist');
+    const checkBadge = (selector, count) => {
+        button()
+            .find(selector, { timeout: timeOut })
+            .should(count > 0 ? 'have.text' : 'not.exist', ...(count > 0 ? [count.toString()] : []));
+    };
+    checkBadge('[counter-muted]', greyCount);
+    checkBadge('[counter]:not([counter-muted])', redCount);
+});
 Cypress.Commands.add('GLO_selectCompany', (companyName) => {
     cy.GLO_addInput(['ng2$svy_nav_login', 'company'], companyName);
     cy.get('[data-cy="ng2$svy_nav_login.btnLogin"]').click();
@@ -732,27 +743,41 @@ Cypress.Commands.add('GLO_selectTab', (selector, tabName, openOrClose) => {
         }
     });
 });
-Cypress.Commands.add('GLO_selectMenuButton', (buttonName, exactMatch = noEqualBool) => {
-    const searchParam = exactMatch ? new RegExp(`^\\s*${Cypress._.escapeRegExp(buttonName)}\\s*$`) : buttonName;
-    cy.GLO_clickDatacontrolBrowserButton('btnMenu');
+// True when the workflow menu has an entry whose text equals the button text.
+const checkForExactMatch = ($menu, exactText) => $menu
+    .find('.dx-menu-item-text')
+    .toArray()
+    .some((element) => exactText.test(element.textContent ?? ''));
+// Clicks a workflow entry in the open workflow menu. An entry whose text equals buttonName wins over entries
+// that only contain it (e.g. 'Confirm' over a 'Confirm with discrepancies - ...' status change listed above it);
+// without an exact entry it falls back to the first entry containing buttonName, unless exactMatch is set.
+// The choice is made inside .filter(), a query that Cypress retries on the live menu, so it is never decided on a
+// menu that is still rendering or on a snapshot of it.
+const clickWorkflowMenuItem = (buttonName, exactMatch) => {
+    const exactText = new RegExp(`^\\s*${Cypress._.escapeRegExp(buttonName)}\\s*$`);
     cy.GLO_getVisible('.dx-submenu', 10000)
-        .contains(searchParam)
+        .find('.dx-menu-item-text')
+        .filter((_index, element) => {
+        const text = element.textContent ?? '';
+        if (exactMatch || checkForExactMatch(Cypress.$(element).closest('.dx-submenu'), exactText)) {
+            return exactText.test(text);
+        }
+        return text.includes(buttonName);
+    })
+        .first()
         .click()
         .then(() => {
         cy.GLO_checkLoadingIndicator();
     });
     cy.GLO_log(` - Used workflow button '${buttonName}'`);
+};
+Cypress.Commands.add('GLO_selectMenuButton', (buttonName, exactMatch = noEqualBool) => {
+    cy.GLO_clickDatacontrolBrowserButton('btnMenu');
+    clickWorkflowMenuItem(buttonName, exactMatch);
 });
 Cypress.Commands.add('GLO_selectMenuButtonControlView', (tabName, buttonName, exactMatch = noEqualBool) => {
-    const searchParam = exactMatch ? new RegExp(`^\\s*${Cypress._.escapeRegExp(buttonName)}\\s*$`) : buttonName;
     cy.GLO_clickDatacontrolViewerButton(tabName, 'btnMenu');
-    cy.GLO_getVisible('.dx-submenu', 10000)
-        .contains(searchParam)
-        .click()
-        .then(() => {
-        cy.GLO_checkLoadingIndicator();
-    });
-    cy.GLO_log(` - Used workflow button '${buttonName}'`);
+    clickWorkflowMenuItem(buttonName, exactMatch);
 });
 const navItem = (topBottom, programName, tabNumber, mode) => {
     if (topBottom !== top && topBottom !== bottom)

package/dist/types.d.ts

@@ -11,6 +11,7 @@ type customValueTypeUndefined = customValueType | undefined;
 type deleteRecordsType = 'DELETE_CYPRESS_RECORDS' | 'DELETE_LEAPWORK_RECORDS';
 type viewModeButtonType = 'btnList' | 'btnDetail';
 type datacontrolbuttonType = baseDatacontrolViewerButtonType | viewModeButtonType | 'btnPrev' | 'btnNext' | 'btnAll' | 'btnPivot' | 'btnAttachment' | 'btnAddMode' | 'btnEditMode' | 'btnDeleteMode' | 'btnDeeplink' | 'btnExtendedSearch' | 'btnCustomViews' | 'btnFilter' | 'btnClearAllFilters';
+type datacontrolCounterButtonType = 'btnAttachment' | 'btnNotification';
 type checkValueInGridType = string | string[] | number;
 type selectMenuButtonLeftType = 'home' | 'settings' | 'help' | 'support' | 'excel' | 'info' | 'refresh' | 'query' | 'clients' | 'users' | 'theme';
 type urlTypeType = 'online' | 'pos' | 'globgate' | 'globjob' | 'globscan' | 'portal' | 'carrier' | 'globtrace' | 'external_portal' | 'globtake' | 'globis_external_portal';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@globisnv/cypress-core",
-    "version": "2.0.0",
+    "version": "2.1.1",
     "description": "Core building blocks for Globis Cypress E2E tests",
     "license": "UNLICENSED",
     "type": "module",