@globisnv/cypress-core 2.3.1 → 2.4.1

package/biome.json

@@ -1,12 +1,12 @@
 {
-    "$schema": "https://biomejs.dev/schemas/2.5.15/schema.json",
+    "$schema": "https://biomejs.dev/schemas/2.6.3/schema.json",
     "vcs": {
         "enabled": true,
         "clientKind": "git",
         "useIgnoreFile": true
     },
     "files": {
-        "includes": ["**", "!dist", "!template"]
+        "includes": ["**", "!dist", "!template", "!**/*.md", "!**/*.yml"]
     },
     "formatter": {
         "enabled": true,

package/dist/blueprints/GLO_commandlist.js

@@ -5,6 +5,6 @@ export const GLO_enterCommandlist = (obj) => {
     cy.GLO_addDate(input, [formName, 'valid_from'], obj.validFrom);
     cy.GLO_addDate(input, [formName, 'valid_till'], obj.validTo);
     cy.GLO_checkbox([formName, 'allow_automatic_update'], obj.allowAutomaticUpdate);
-    cy.GLO_popupWindow([formName, 'btn_select_relation'], obj.customerRelation);
+    cy.GLO_popupWindow([formName, 'relation_id'], obj.customerRelation);
     cy.GLO_addInput([formName, 'commandlist_code'], obj.commandlistCode);
 };

package/dist/blueprints/GLO_consignment.d.ts

@@ -56,6 +56,8 @@ export type objConsignment = {
     etd?: string;
     eta?: string;
     fileReference?: string;
+    loadStartRequested?: string;
+    unloadStartRequested?: string;
 };
 export declare const GLO_enterConsignment: (obj: objConsignment, formName?: string, formNameGeneral?: string, formNameSea?: string, formNameWarehouse?: string) => void;
 export declare const GLO_enterConsignment$Terminal: (obj: objConsignment) => void;

package/dist/blueprints/GLO_consignment.js

@@ -1,4 +1,4 @@
-import { close, equal, input, open } from '../tsHelper.js';
+import { close, equal, equalBool, input, open, typeSearch } from '../tsHelper.js';
 import { GLO_enterAddressPopup } from './GLO_addressPopup.js';
 const defaultFormName = 'ng$consignment_dtl';
 const defaultFormNameGeneral = 'ng$consignment_dtl_general';
@@ -29,7 +29,14 @@ export const GLO_enterConsignment = (obj, formName = defaultFormName, formNameGe
         cy.GLO_addInput([formName, 'equipment_type_id'], obj.equipmentType);
         cy.GLO_checkLoadingIndicator();
     }
-    if (obj.collectionAddress || obj.deliveryAddress || obj.loadStartBooked || obj.loadEndBooked || obj.loadStartBookedTime || obj.loadEndBookedTime) {
+    if (obj.collectionAddress ||
+        obj.deliveryAddress ||
+        obj.loadStartBooked ||
+        obj.loadEndBooked ||
+        obj.loadStartBookedTime ||
+        obj.loadEndBookedTime ||
+        obj.loadStartRequested ||
+        obj.unloadStartRequested) {
         cy.GLO_selectTab([formName, 'tabs_70'], 'General', open);
         if (obj.collectionAddress) {
             cy.GLO_clickButton([formNameGeneral, 'btn_select_from_address'], 'fa-search-plus');
@@ -43,6 +50,8 @@ export const GLO_enterConsignment = (obj, formName = defaultFormName, formNameGe
             obj.deliveryAddress.type ??= 'search';
             GLO_enterAddressPopup(obj.deliveryAddress);
         }
+        cy.GLO_addDate(input, [formNameGeneral, 'load_start_requested'], obj.loadStartRequested);
+        cy.GLO_addDate(input, [formNameGeneral, 'unload_start_requested'], obj.unloadStartRequested);
         cy.GLO_addDate(input, [formNameGeneral, 'load_start_booked'], obj.loadStartBooked);
         cy.GLO_addDate(input, [formNameGeneral, 'load_start_booked_time'], obj.loadStartBookedTime);
         cy.GLO_addDate(input, [formNameGeneral, 'load_end_booked'], obj.loadEndBooked);
@@ -87,8 +96,8 @@ const seaTab = (obj, formName, formNameSea) => {
     cy.GLO_addInput([formNameSea, 'txt_shipper_reference'], obj.shipperRef);
     cy.GLO_addInput([formNameSea, 'supplier_incoterm'], obj.shipperIncoTerm);
     cy.GLO_addInput([formNameSea, 'quay_code'], obj.quayCode);
-    cy.GLO_addInput([formNameSea, 'from_logistic_location'], obj.POL);
-    cy.GLO_addInput([formNameSea, 'to_logistic_location'], obj.POD);
+    cy.GLO_popupWindow([formNameSea, 'from_logistic_location'], obj.POL, undefined, equalBool, typeSearch);
+    cy.GLO_popupWindow([formNameSea, 'to_logistic_location'], obj.POD, undefined, equalBool, typeSearch);
     cy.GLO_addInput([formNameSea, 'transport_method'], obj.transportMethod);
     cy.GLO_addDate(input, [formNameSea, 'atd'], obj.atd);
     cy.GLO_addDate(input, [formNameSea, 'goods_closing'], obj.goodsClosing);

package/dist/blueprints/GLO_priceRequestLine.js

@@ -12,6 +12,8 @@ export const GLO_enterPriceRequestLine$Terminal = (obj) => {
         cy.GLO_addInput([qtFormName, 'gross_price'], obj.grossPriceTwo);
         cy.GLO_addInput([qtFormName, 'purchase_costs_euro'], obj.purchaseCostTwo);
         cy.GLO_addInput([qtFormName, 'discount_amount'], obj.discountTwoValue);
+        if (obj.discountTwoValue)
+            cy.GLO_checkLoadingIndicator();
         cy.GLO_addInput([qtFormName, 'discount_percentage'], obj.discountTwoPercentage);
     });
 };

package/dist/blueprints/GLO_quotationLine.js

@@ -11,6 +11,11 @@ const enterQuotationLine = (useNew, obj) => {
     const formNameInnerBreak = 'ng$quotationlines_dtl_quantity';
     const articleSelector = useNew ? 'article_code' : 'btn_select_article';
     cy.GLO_popupWindow([formName, articleSelector], obj.articleCode);
+    // The article selection triggers a double load, so wait until the field really holds the article
+    // A falsy article code leaves the current article untouched, so there is nothing to wait for
+    if (obj.articleCode) {
+        cy.GLO_checkField([formName, 'article_code'], obj.articleCode, undefined, 300000);
+    }
     if (obj.quantityBreaks && obj.quantityBreaks.length > 0) {
         cy.GLO_selectTab([formName, 'tabs_470'], 'Quantity breaks', open);
         obj.quantityBreaks.forEach((qtyBreak, index) => {

package/dist/commands/FOB_commands.js

@@ -167,7 +167,7 @@ Cypress.Commands.add('FOB_showGridColumn', (column, shouldShow) => {
         else {
             $checkbox = $sidebar
                 .find('.ag-column-select-column-label')
-                .filter((_, el) => new RegExp(`^${column}$`, 'i').test(el.innerText))
+                .filter((_, el) => new RegExp(`^${column}$`, 'i').test(el.textContent ?? ''))
                 .closest('.ag-column-select-column')
                 .find('input.ag-checkbox-input');
         }

package/dist/commands/GLO_commands.d.ts

@@ -570,9 +570,11 @@ declare global {
              */
             GLO_clickButtonInGrid(buttonColumn: string, rowFilter?: string | number, validationColumn?: string, x?: number, y?: number): Chainable<JQuery>;
             /**
-             * Command to login using Okta, like GLO_oktaLogin, but with the simple addition of a boolean parameter to switch between 2 different accounts.
+             * Log out and continue as the default (username) or the alternate (username2) SSO user, Okta or Keycloak.
              *
-             * This landing page is not the same as the initial portal. It can only be used when switching users after logging out from a Globis environment.
+             * The login is stateless: the logout ends only the app session and the IdP signs the app straight back in.
+             * Returning to the user that holds the IdP session is therefore only a logout. Switching to the other user
+             * clears the IdP session and logs in on the IdP page.
              *
              * @param {usernameFlag} [altUser] - Switch to decide whether a secondary (alternateUsername) account has to be logged into or (defaultUsername) the primary account.
              * @param {string} [company] - Name of a company to switch to after successfully logging in.
@@ -610,6 +612,36 @@ declare global {
              * @param {number} [interval] - use this TOGETHER with timeOut for slow-running updates (e.g. batch process) (default: 15s)
              */
             GLO_validateGridOrFail(waitValue: string, failValue: string, rowNumber?: number, columnId?: string, timeOut?: number, interval?: number): void;
+            /**
+             * Command to wait until a field shows a value, and to fail instantly when it shows a fail value.
+             * The field counterpart of GLO_validateGridOrFail, e.g. for a status that is updated by a running process.
+             * The displayed value is checked, as in GLO_checkField (the text of a valuelist, not its stored code).
+             *
+             * @param {selectorType} selector - [formName, elementName] of the field.
+             * @param {string} waitValue - The value to wait for.
+             * @param {string | string[]} failValue - The value(s) that stop the waiting and fail instantly.
+             * @param {number} [timeOut] - how long it should wait for the field to update, default: 10m
+             * @param {number} [interval] - how often the field is checked, default: 15s
+             * @example - cy.GLO_validateFieldOrFail(['ng$billing_task_dtl', 'status'], 'Finished', ['Error', 'Finished with error'], 300000, 2000);
+             */
+            GLO_validateFieldOrFail(selector: selectorType, waitValue: string, failValue: string | string[], timeOut?: number, interval?: number): void;
+            /**
+             * Executes a batch processing type and waits until the run it started has finished.
+             * The last run of the type is remembered before Execute, so a run that finished earlier is never taken for
+             * the new one (row 0 of the 'Batch processing' tab is still the previous run right after Execute).
+             * The command opens 'Batch processing type' itself and closes it again when the run has finished.
+             *
+             * @param {string} batchType - The value to filter the batch processing type list on.
+             * @param {string} [columnId='description'] - The column of the batch processing type list to filter on (e.g. 'description', 'transaction_type_text', 'batch_module').
+             * @param {string | null} [waitValue='Completed'] - The status the new run must end with. Use null to only wait until the run has finished, whatever its status,
+             * e.g. for a batch that processes the records of the whole environment, where one record of a parallel test can turn the run into Error.
+             * @param {string} [failValue='Error'] - The status that stops the waiting and fails instantly (not used when waitValue is null).
+             * @param {number} [timeOut] - how long it should wait for the run to finish, default: 20m
+             * @param {number} [interval] - how often the 'Batch processing' tab is checked, default: 15s
+             * @returns {Chainable<batchRunType>} - Yields the new run (submitted, completed, status, error message).
+             * @example - cy.GLO_executeBatchProcess('Batch processor accountancy SALES', 'batch_module', null);
+             */
+            GLO_executeBatchProcess(batchType: string, columnId?: string, waitValue?: string | null, failValue?: string, timeOut?: number, interval?: number): Chainable<batchRunType>;
             /**
              * Store the value(s) of one or more fields into the nested '@saveData' alias:
              *   saveData[formName][elementName] = value

package/dist/commands/GLO_commands.js

@@ -1,4 +1,4 @@
-import { bottom, buttonSearch, check, contains, cypressWebsocketLoader, defaultTimeout, enabled, equal, greaterEqual, gridDropDown, gridInput, gridInputWithoutEnter, gridSelect, hideInCommandLog, input, isInvalid, noEqualBool, noSkipCheck, notEqual, parseLocalizedNumber, row, select, skipCheck, span, top, unCheck } from '../tsHelper.js';
+import { bottom, buttonSearch, check, contains, cypressWebsocketLoader, defaultTimeout, enabled, equal, greaterEqual, gridDropDown, gridInput, gridInputWithoutEnter, gridSelect, hideInCommandLog, input, isInvalid, noEqualBool, noSkipCheck, notEqual, open, parseLocalizedNumber, row, select, skipCheck, span, top, unCheck } from '../tsHelper.js';
 import { attachWebSocketSpy } from '../websocketDetector.js';
 //! File-specific helpers
 const monthNames = ['januari', 'februari', 'maart', 'april', 'mei', 'juni', 'juli', 'augustus', 'september', 'oktober', 'november', 'december'];
@@ -192,43 +192,46 @@ const waitForWebSocketAfterSso = (idp = ssoUrl()) => {
         cy.task('log', `WebSocket spy confirmed connected, ${win.wsMessages?.messages.length} messages captured so far`);
     });
 };
-const oktaIdpLogin = () => {
-    cy.origin(ssoUrl(), () => {
+// userEnv/passwordEnv name the env values to log in with, 'username2'/'password2' for the alternate user
+const oktaIdpLogin = (userEnv = 'username', passwordEnv = 'password') => {
+    cy.origin(ssoUrl(), { args: { userEnv, passwordEnv } }, ({ userEnv, passwordEnv }) => {
         cy.get('.o-form-input', { timeout: 60000 })
             .find('[autocomplete="username"]')
             .clear()
-            .type(Cypress.expose('username'));
+            .type(Cypress.expose(userEnv));
         cy.task('log', 'Filled in username');
         cy.get('[type="submit"]').click();
-        cy.env(['password']).then(({ password }) => {
+        cy.env([passwordEnv]).then((envVars) => {
             cy.get('.o-form-input')
                 .find('[type="password"]', { timeout: 20000 })
-                .type(password, { log: false });
+                .type(envVars[passwordEnv], { log: false });
         });
         cy.task('log', 'Filled in password');
         cy.get('[type="submit"]').click();
     });
 };
-// Keycloak: username page, password page, then a one-time code page when the user has OTP (otpSecret is set)
-const keycloakIdpLogin = () => {
+// Keycloak: username page, password page, then a one-time code page when the user has OTP (otpSecret is set).
+// otpSecret belongs to the default user, so the alternate user is logged in without a code.
+const keycloakIdpLogin = (userEnv = 'username', passwordEnv = 'password') => {
     // The code is made outside cy.origin: a task that waits for a free OTP window times out after 4s inside it.
     // It is claimed right before the IdP pages, so it is still fresh when typed.
     cy.env(['otpSecret']).then(({ otpSecret }) => {
-        if (otpSecret)
-            cy.task('totp', otpSecret, { log: false, timeout: 200000 }).then((code) => keycloakOrigin(code));
+        if (otpSecret && userEnv === 'username') {
+            cy.task('totp', otpSecret, { log: false, timeout: 200000 }).then((code) => keycloakOrigin(code, userEnv, passwordEnv));
+        }
         else
-            keycloakOrigin(undefined);
+            keycloakOrigin(undefined, userEnv, passwordEnv);
     });
 };
-const keycloakOrigin = (code) => {
-    cy.origin(ssoUrl(), { args: { code } }, ({ code }) => {
+const keycloakOrigin = (code, userEnv, passwordEnv) => {
+    cy.origin(ssoUrl(), { args: { code, userEnv, passwordEnv } }, ({ code, userEnv, passwordEnv }) => {
         cy.get('input[name="username"]', { timeout: 60000 })
             .clear()
-            .type(Cypress.expose('username'));
+            .type(Cypress.expose(userEnv));
         cy.task('log', 'Filled in username');
         cy.get('#kc-login').click();
-        cy.env(['password']).then(({ password }) => {
-            cy.get('input[name="password"]', { timeout: 20000 }).type(password, { log: false });
+        cy.env([passwordEnv]).then((envVars) => {
+            cy.get('input[name="password"]', { timeout: 20000 }).type(envVars[passwordEnv], { log: false });
             cy.task('log', 'Filled in password');
             cy.get('#kc-login').click();
             if (code) {
@@ -240,6 +243,15 @@ const keycloakOrigin = (code) => {
         });
     });
 };
+const idpLogin = (userEnv = 'username', passwordEnv = 'password') => {
+    if (ssoProvider() === 'okta')
+        oktaIdpLogin(userEnv, passwordEnv);
+    else
+        keycloakIdpLogin(userEnv, passwordEnv);
+};
+// Whether the IdP session currently belongs to the alternate user (username2), see GLO_oktaAlternativeLogin.
+// ssoLogin restores the default user's IdP session, so it resets this.
+let ssoAlternateUserActive = false;
 // One IdP login per run (cy.session, also across specs): every later call only revisits the app,
 // which the IdP signs in silently, so no password/OTP is asked again.
 // ponytail: no `validate` — an expired IdP session shows up as a login page, add a validate if that happens
@@ -262,10 +274,7 @@ const ssoLogin = (company, urlType, skipvNavCheck) => {
             // AUT page load (see websocketDetector.ts), which covers this server-side redirect too.
             cy.visit(url);
             cy.task('log', `Redirect to ${provider} url`);
-            if (provider === 'okta')
-                oktaIdpLogin();
-            else
-                keycloakIdpLogin();
+            idpLogin();
             // Let the app finish its login callback, then keep only the IdP cookies: the app's own client session
             // does not survive a restore, so every call starts a fresh app client that the IdP signs in silently.
             if (cypressWebsocketLoader)
@@ -292,6 +301,7 @@ const ssoLogin = (company, urlType, skipvNavCheck) => {
             }
         });
     }, { cacheAcrossSpecs: true });
+    ssoAlternateUserActive = false;
     cy.visit(url);
     if (company) {
         cy.GLO_selectCompany(company);
@@ -694,8 +704,8 @@ const GLO_inputValuelist = (selector, rawValue) => {
                         cy.get('@before').then(($before) => {
                             getDropdown('.dx-scrollview-content .dx-item', 30000)
                                 .should(($current) => {
-                                const initialTexts = [...$before].map((el) => el.innerText.trim());
-                                const currentTexts = [...$current].map((el) => el.innerText.trim());
+                                const initialTexts = [...$before].map((el) => (el.textContent ?? '').trim());
+                                const currentTexts = [...$current].map((el) => (el.textContent ?? '').trim());
                                 const hasChanged = !Cypress._.isEqual(currentTexts, initialTexts);
                                 // Also accept when the list is the same size or larger: branch-filtered valuelists
                                 // with few options won't change after clearing because the full list IS the filtered list.
@@ -733,8 +743,8 @@ const GLO_inputValuelist = (selector, rawValue) => {
                     cy.get('@before')
                         .then(($before) => {
                         getDropdown('.dx-scrollview-content .dx-item', 30000).should(($current) => {
-                            const initialTexts = [...$before].map((el) => el.innerText.trim());
-                            const currentTexts = [...$current].map((el) => el.innerText.trim());
+                            const initialTexts = [...$before].map((el) => (el.textContent ?? '').trim());
+                            const currentTexts = [...$current].map((el) => (el.textContent ?? '').trim());
                             const hasChanged = !Cypress._.isEqual(currentTexts, initialTexts);
                             const anyIncludes = currentTexts.every((text) => text.includes(dropdownValue));
                             // An empty list is the transitional state while the filtered valuelist is still loading, never a valid result.
@@ -1232,7 +1242,7 @@ Cypress.Commands.add('GLO_selectRowInGrid', (rowFilter) => {
     cy.get('[row-index]')
         .filter(isInOpenContainer)
         .each(($row) => {
-        const cellTexts = Array.from($row.find('.ag-cell-value')).map((el) => el.innerText.trim());
+        const cellTexts = Array.from($row.find('.ag-cell-value')).map((el) => (el.textContent ?? '').trim());
         // Check to see if all requested values are present in any of the cells.
         const matches = filters.every((filterValue) => cellTexts.some((val) => val.includes(filterValue)));
         if (matches) {
@@ -1453,7 +1463,8 @@ Cypress.Commands.add('GLO_popupWindow', (selector, value, columnId, equals = noE
             selectFromPopupWindow(value, columnId, equals);
         }
         else {
-            cy.GLO_checkField(selector, value, equals ? contains : undefined);
+            // Type search with an exact match must stay exact: a contains check would accept LOC1 for LOC10.
+            cy.GLO_checkField(selector, value, equals ? (useMagnifierFlag ? contains : equal) : undefined);
         }
     });
 });
@@ -1956,6 +1967,9 @@ Cypress.Commands.add('GLO_fillInfieldInGrid', (selector, rowFilter, columnId, va
         cy.GLO_getElement(selector).within(() => {
             cy.GLO_clickRowInGrid(rowFilter, columnId);
         });
+        // Re-check outside the .within(): loading-indicator renders at page level, so the check
+        // inside GLO_clickRowInGrid (scoped to the grid element above) can't see it and resolves early.
+        cy.GLO_checkLoadingIndicator();
         // biome-ignore lint/plugin/noUnnecessaryWaiting: else both click and dblclick fire too fast
         cy.wait(500);
         cy.GLO_dblClickRowInGrid(row, selector, rowFilter, columnId, skipCheck);
@@ -2052,56 +2066,37 @@ Cypress.Commands.add('GLO_clickButtonInGrid', { prevSubject: ['optional', 'eleme
     }
     cy.GLO_checkLoadingIndicator();
 });
+// Stateless SSO login: the logout only ends the app's Servoy client, the IdP session stays. The app starts a
+// fresh client right away, which the IdP signs in silently as the user that holds the IdP session, so there is
+// no IdP login page to fill in. Getting back to that user is just the logout. Another user needs the IdP session
+// dropped first, so the IdP asks for credentials again.
 Cypress.Commands.add('GLO_oktaAlternativeLogin', (altUser, company) => {
-    cy.GLO_logout();
-    // biome-ignore lint/plugin/noUnnecessaryWaiting: wait for Okta to process logout
-    cy.wait(10000);
+    const userEnv = altUser ? 'username2' : 'username';
+    const passwordEnv = altUser ? 'password2' : 'password';
+    const switchIdpUser = Boolean(altUser) !== ssoAlternateUserActive;
     if (cypressWebsocketLoader) {
         cy.on('window:before:load', (win) => {
             attachWebSocketSpy(win);
         });
     }
-    if (altUser) {
-        cy.origin(ssoUrl(), () => {
-            cy.get('.okta-container', { timeout: 120000 });
-            cy.get('.o-form-input', { timeout: 60000 })
-                .find('[autocomplete="username"]')
-                .clear()
-                .type(Cypress.expose('username2'));
-            cy.task('log', 'Filled in username');
-            cy.get('[type="submit"]').click();
-            cy.env(['password2']).then(({ password2 }) => {
-                cy.get('.o-form-input')
-                    .find('[type="password"]', { timeout: 20000 })
-                    .type(password2, { log: false });
-            });
-            cy.task('log', 'Filled in password');
-            cy.get('[type="submit"]').click();
-        });
-        cy.GLO_log(`Logged in as ${Cypress.expose('username2')}`);
-    }
-    else {
-        cy.origin(ssoUrl(), () => {
-            cy.get('.okta-container', { timeout: 120000 });
-            cy.get('.o-form-input', { timeout: 60000 })
-                .find('[autocomplete="username"]')
-                .clear()
-                .type(Cypress.expose('username'));
-            cy.task('log', 'Filled in username');
-            cy.get('[type="submit"]').click();
-            cy.env(['password']).then(({ password }) => {
-                cy.get('.o-form-input')
-                    .find('[type="password"]', { timeout: 20000 })
-                    .type(password, { log: false });
-            });
-            cy.task('log', 'Filled in password');
-            cy.get('[type="submit"]').click();
-        });
-        cy.GLO_log(`Logged in as ${Cypress.expose('username')}`);
-    }
+    // Come back on the solution the test is in (GLO_login can start another one than globisUrl), without the hash state
+    cy.location({ log: false }).then((location) => {
+        const appUrl = `${location.origin}${location.pathname}${location.search}`;
+        cy.GLO_logout();
+        if (switchIdpUser) {
+            // clearAllCookies clears every domain, the IdP session included (clearCookies would only clear the app's)
+            cy.clearAllCookies({ log: false });
+            cy.clearAllSessionStorage({ log: false }); // the solution start fails on a missing owner_id otherwise
+            cy.visit(appUrl);
+            idpLogin(userEnv, passwordEnv);
+            ssoAlternateUserActive = Boolean(altUser);
+        }
+    });
     if (cypressWebsocketLoader)
         waitForWebSocketAfterSso();
     cy.get('[data-cy$="ng$main_form2.navbar_top"]', { timeout: 120000 }).should('exist');
+    cy.GLO_checkLoadingIndicator();
+    cy.GLO_log(`Logged in as ${Cypress.expose(userEnv)}`);
     if (company)
         cy.GLO_checkAndSelectCompany(company);
 });
@@ -2124,6 +2119,120 @@ Cypress.Commands.add('GLO_getAllRowsInGrid', (selector, timeOut = defaultTimeout
 Cypress.Commands.add('GLO_validateGridOrFail', (waitValue, failValue, rowNumber, columnId, timeOut = 600000, interval = 15000) => {
     validateGridValue(waitValue, failValue, rowNumber, columnId, timeOut, interval);
 });
+Cypress.Commands.add('GLO_validateFieldOrFail', (selector, waitValue, failValue, timeOut = 600000, interval = 15000) => {
+    const failValues = Array.isArray(failValue) ? failValue : [failValue];
+    const maxAttempts = Math.max(1, Math.ceil(timeOut / interval));
+    const fieldName = selector.join('.');
+    // A trailing index picks a grid row or, on a field with several inputs, the input: same as GLO_checkField
+    const { baseSelector, index } = extractSelectorParts(selector);
+    const checkField = (attempt = 1) => {
+        // Decided on every attempt and only once the field is in the DOM: a grid that is still rendering would
+        // otherwise be taken for a field with several inputs, and that choice would stick for the whole poll.
+        // A grid row is then looked up with the full selector, so GLO_getElement waits for that row itself.
+        cy.GLO_getElement(baseSelector).then(() => {
+            const inGrid = isGridRowSelector(baseSelector, index);
+            const effectiveIndex = inGrid ? 0 : index;
+            // Same value as GLO_checkField reads: the displayed text, with html and other unicode spaces normalized
+            cy.GLO_getElement(inGrid ? selector : baseSelector).then(($field) => {
+                const fieldValue = String($field.find('.dx-texteditor-input').eq(effectiveIndex).val()).replace(/\s+/g, ' ').trim();
+                if (fieldValue === waitValue) {
+                    cy.log(`${fieldName} is "${waitValue}"`);
+                    return;
+                }
+                if (failValues.includes(fieldValue)) {
+                    throw new Error(`${fieldName} is "${fieldValue}" (waited for "${waitValue}")`);
+                }
+                if (attempt >= maxAttempts) {
+                    throw new Error(`${fieldName} is still "${fieldValue}" after ${timeOut / 1000}s (waited for "${waitValue}")`);
+                }
+                // biome-ignore lint/plugin/noUnnecessaryWaiting: wait for next poll interval before checking again
+                cy.wait(interval, { log: false }).then(() => {
+                    checkField(attempt + 1);
+                });
+            });
+        });
+    };
+    checkField();
+});
+Cypress.Commands.add('GLO_executeBatchProcess', (batchType, columnId = 'description', waitValue = 'Completed', failValue = 'Error', timeOut = 1200000, interval = 15000) => {
+    const formNameTypeList = 'ng$batch_execution_type_lst';
+    const formNameTypeTab = 'ng$batch_execution_type_tab';
+    const formNameRunList = 'ng$batch_execution_lst';
+    const maxAttempts = Math.max(1, Math.ceil(timeOut / interval));
+    // Row 0 of the run list is the most recent run (sorted on process_submitted desc); an empty list has no run yet.
+    // Without these columns (hidden in a custom view) a new run can never be recognised, so that fails at once.
+    const requiredColumns = ['process_submitted', 'process_completed', 'process_status'];
+    const readLastRun = () => {
+        const noRun = { submitted: '', completed: '', status: '', errorMessage: '' };
+        return cy.GLO_getElement([formNameRunList, 'grid']).then(($grid) => {
+            if ($grid.find(gridDataRows).length === 0) {
+                return cy.wrap(noRun, { log: false });
+            }
+            return cy
+                .wrap($grid, { log: false })
+                .within(() => {
+                cy.GLO_getRowInGrid(0).then(($row) => {
+                    const missingColumns = requiredColumns.filter((requiredColumnId) => $row.find(`[col-id="${requiredColumnId}"]`).length === 0);
+                    if (missingColumns.length) {
+                        throw new Error(`The 'Batch processing' tab of ${batchType} does not show the column(s) ${missingColumns.join(', ')}`);
+                    }
+                    const cellText = (cellColumnId) => $row.find(`[col-id="${cellColumnId}"]`).text().trim();
+                    cy.wrap({
+                        submitted: cellText('process_submitted'),
+                        completed: cellText('process_completed'),
+                        status: cellText('process_status'),
+                        errorMessage: cellText('last_error_message')
+                    }, { log: false }).as('COM_batchRun');
+                });
+            })
+                .then(() => cy.get('@COM_batchRun', { log: false }));
+        });
+    };
+    // The completion time (process_completed) is stamped for every final status, Completed as well as Error
+    const waitForNewRun = (previousSubmitted, attempt = 1) => {
+        cy.GLO_checkAGLoader();
+        return readLastRun().then((run) => {
+            const isNewRun = run.submitted !== '' && run.submitted !== previousSubmitted;
+            const hasFailed = waitValue !== null && run.status === failValue;
+            if (isNewRun && (run.completed !== '' || hasFailed)) {
+                cy.GLO_log(`Batch run of ${run.submitted} (${batchType}) finished with status "${run.status}" ${run.errorMessage}`);
+                if (hasFailed) {
+                    throw new Error(`Batch run of ${run.submitted} (${batchType}) ended with status "${run.status}": ${run.errorMessage}`);
+                }
+                if (waitValue !== null) {
+                    expect(run.status, `status of the batch run of ${run.submitted} (${batchType})`).to.equal(waitValue);
+                }
+                return cy.wrap(run, { log: false });
+            }
+            if (attempt >= maxAttempts) {
+                throw new Error(`No finished run of ${batchType} after ${timeOut / 1000}s (last run submitted: ${run.submitted})`);
+            }
+            // biome-ignore lint/plugin/noUnnecessaryWaiting: wait for next poll interval before checking again
+            return cy.wait(interval, { log: false }).then(() => waitForNewRun(previousSubmitted, attempt + 1));
+        });
+    };
+    cy.GLO_searchHeader('Batch processes', 'Batch processes', 'Batch processing type');
+    cy.GLO_clickDatacontrolBrowserButton('btnAll');
+    // A filter typed while the list is still loading is lost
+    cy.GLO_checkAGLoader();
+    // Equals, not contains: 'CALCULATE INVOICE' must not select 'CALCULATE INVOICE RETOUR'
+    cy.GLO_filterGrid(columnId, [formNameTypeList, 'grid'], batchType, undefined, 'Equals');
+    cy.GLO_getElement([formNameTypeList, 'grid']).within(() => {
+        cy.GLO_checkValueGrid(batchType, 0, columnId, undefined, undefined, equal);
+    });
+    cy.GLO_selectTab([formNameTypeTab, 'tabs'], 'Batch processing', open);
+    cy.GLO_checkAGLoader();
+    return readLastRun().then((previousRun) => {
+        cy.GLO_selectMenuButton('Execute');
+        cy.GLO_log(`Executed batch processing type ${batchType}`);
+        return waitForNewRun(previousRun.submitted).then((run) => {
+            // Every call opens the program, so it is closed again: a second instance would keep a hidden run list in
+            // the page, and the caller gets back the programs it had open
+            cy.GLO_closeProgram(top, 'Batch processing type');
+            return cy.wrap(run, { log: false });
+        });
+    });
+});
 const validateGridValue = (value, failValue, rowFilter, columnId, timeOut = 10000, interval, operator = contains) => {
     const assertOrCheckCellValue = ($cells, toCheck, doAssert) => {
         const compare = (cellText) => {
@@ -2222,21 +2331,22 @@ const validateGridValue = (value, failValue, rowFilter, columnId, timeOut = 1000
         cy.then(() => promise);
     }
 };
-Cypress.Commands.add('GLO_getCurrentRecordCount', () => {
-    return cy
-        .GLO_getElement(['ng$datacontrol', 'datacontrol'])
-        .find('#txtCount')
-        .invoke('text')
-        .then((records) => {
-        const [currentStr, totalStr] = records.split('/');
-        if (!currentStr || !totalStr) {
-            throw new Error(`Could not parse record count from "${records}"`);
-        }
-        return {
-            currentRecord: parseInt(currentStr.trim(), 10),
-            totalRecords: parseInt(totalStr.trim(), 10)
-        };
-    });
+Cypress.Commands.addQuery('GLO_getCurrentRecordCount', function (timeOut) {
+    // this.set('timeout', ...) is how the Cypress docs give a custom query its timeout, but the typings leave
+    // 'timeout' out of EnqueuedCommandAttributes
+    if (timeOut !== undefined)
+        this.set('timeout', timeOut);
+    return () => {
+        const $count = Cypress.$('div[formslist]:not([hidden]) [data-cy$="ng$datacontrol.datacontrol"] #txtCount');
+        const text = $count.first().text();
+        const [currentRecord, totalRecords] = text.split('/').map((part) => Number.parseInt(part.trim(), 10));
+        // Throwing makes the query retry: while the datacontrol is still rendering there is no count (or no
+        // '<current>/<total>' text yet), and returning NaN would let the caller go on with an invalid count
+        if ($count.length === 0 || !Number.isInteger(currentRecord) || !Number.isInteger(totalRecords)) {
+            throw new Error(`No record count on the active datacontrol yet (#txtCount: "${text}")`);
+        }
+        return { currentRecord, totalRecords };
+    };
 });
 Cypress.Commands.add('GLO_storeObject', (formName, elementNames, index, log = hideInCommandLog) => {
     const keys = (Array.isArray(elementNames) ? elementNames : [elementNames]);

package/dist/commands/GLS_commands.js

@@ -14,28 +14,43 @@ Cypress.Commands.add('GLS_login', (username = 'PR001', company) => {
     cy.GLO_checkLoadingIndicator();
 });
 Cypress.Commands.add('GLS_mainNavigation', (value) => {
-    const scrollAndSearch = (attempts = 0) => {
-        if (attempts > 20) {
-            throw new Error(`Could not find menu item: ${value}`);
+    // Newer GlobScan versions show the menu as a list form component (VCK-376, 11.0.x), older ones as an AG Grid.
+    // Waits for whichever menu is there and uses that one.
+    const listMenuItems = '.svy-listformcomponent label.clickable';
+    cy.get(`${listMenuItems}, .ag-grid-scrolling-rows`).then(($menu) => {
+        if ($menu.is(listMenuItems)) {
+            // Exact match, so 'Wegzetten' does not open 'Wegzetten drager'. A menu level that is still mounted but hidden is skipped
+            // through its [hidden] container instead of :visible, which also drops items scrolled out of the list (see isInOpenContainer)
+            const exactText = new RegExp(`^\\s*${Cypress._.escapeRegExp(value)}\\s*$`);
+            cy.get(listMenuItems)
+                .filter((_i, el) => !el.closest('[hidden]') && exactText.test(el.textContent ?? ''))
+                .click();
+            cy.GLO_checkLoadingIndicator();
+            return;
         }
-        return cy
-            .get('.ag-grid-scrolling-rows')
-            .first()
-            .then(($viewport) => {
-            const $label = $viewport.find('label').filter((_i, el) => el.innerText.trim() === value);
-            if ($label.length > 0 && $label.is(':visible')) {
-                return cy.contains('.ag-grid-scrolling-rows label', value).click();
+        const scrollAndSearch = (attempts = 0) => {
+            if (attempts > 20) {
+                throw new Error(`Could not find menu item: ${value}`);
             }
             return cy
-                .get('.ag-grid-scrolling-container [role="row"][tabindex="0"]')
+                .get('.ag-grid-scrolling-rows')
                 .first()
-                .focus()
-                .realPress('ArrowDown')
-                .then(() => scrollAndSearch(attempts + 1));
+                .then(($viewport) => {
+                const $label = $viewport.find('label').filter((_i, el) => (el.textContent ?? '').trim() === value);
+                if ($label.length > 0 && $label.is(':visible')) {
+                    return cy.contains('.ag-grid-scrolling-rows label', value).click();
+                }
+                return cy
+                    .get('.ag-grid-scrolling-container [role="row"][tabindex="0"]')
+                    .first()
+                    .focus()
+                    .realPress('ArrowDown')
+                    .then(() => scrollAndSearch(attempts + 1));
+            });
+        };
+        scrollAndSearch().then(() => {
+            cy.GLO_checkLoadingIndicator();
         });
-    };
-    scrollAndSearch().then(() => {
-        cy.GLO_checkLoadingIndicator();
     });
 });
 Cypress.Commands.add('GLS_selectStock', (formName, elementName, index) => {

package/dist/commands/POR_commands.js

@@ -5,7 +5,7 @@ Cypress.Commands.add('POR_checkPortalSideMenuCorrect', (menuItems) => {
         .find('.main-items .item-main , .main-items .item-header')
         .should('have.length.gt', 1)
         .then((elements) => {
-        return Cypress.$.makeArray(elements).map((el) => el.innerText);
+        return Cypress.$.makeArray(elements).map((el) => (el.textContent ?? '').trim());
     })
         .should('deep.eq', menuItems);
     cy.GLO_checkLoadingIndicator();

package/dist/types.d.ts

@@ -13,6 +13,12 @@ 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 batchRunType = {
+    submitted: string;
+    completed: string;
+    status: string;
+    errorMessage: string;
+};
 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';
 type customValueType = JQuery | string | number;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@globisnv/cypress-core",
-    "version": "2.3.1",
+    "version": "2.4.1",
     "description": "Core building blocks for Globis Cypress E2E tests",
     "license": "UNLICENSED",
     "type": "module",
@@ -59,7 +59,7 @@
     "devDependencies": {
         "@biomejs/biome": "^2.5.15",
         "@types/node": "^26.1.2",
-        "cypress": "^16.1.0",
+        "cypress": "^16.2.1",
         "cypress-real-events": "^1.15.1",
         "typescript": "^7.0.2"
     },