Added command to validate form footer buttons

Author: asirvadAbrahamVarghese

cypress/support/commands/command_constants.js

@@ -25,4 +25,11 @@ export const FIELD_TYPES = {
   TEXTAREA: 'textarea',
 };
 
+// Form button configuration keys
+export const BUTTON_CONFIG_KEYS = {
+  BUTTON_TEXT: 'buttonText',
+  BUTTON_TYPE: 'buttonType',
+  SHOULD_BE_DISABLED: 'shouldBeDisabled',
+};
+
 /* ========================================================== */

cypress/support/commands/form_elements_validation_commands.js

@@ -3,6 +3,7 @@ import {
   LABEL_CONFIG_KEYS,
   FIELD_CONFIG_KEYS,
   FIELD_TYPES,
+  BUTTON_CONFIG_KEYS
 } from './command_constants.js';
 
 /**
@@ -187,3 +188,65 @@ Cypress.Commands.add('validateFormFields', (fieldConfigs) => {
     }
   });
 });
+
+/**
+ * Validates form buttons based on provided configurations
+ *
+ * @param {Array} buttonConfigs - Array of button configuration objects
+ * @param {string} buttonConfigs[].buttonText - The text of the button
+ * @param {string} [buttonConfigs[].buttonType='button'] - The type of button (e.g., 'submit', 'reset')
+ * @param {boolean} [buttonConfigs[].shouldBeDisabled=false] - Whether the button should be disabled
+ *
+ * Example:
+ *   cy.validateFormFooterButtons([
+ *     { [BUTTON_CONFIG_KEYS.BUTTON_TEXT]: 'Cancel' },
+ *     { [BUTTON_CONFIG_KEYS.BUTTON_TEXT]: 'Reset', [BUTTON_CONFIG_KEYS.SHOULD_BE_DISABLED]: true },
+ *     { [BUTTON_CONFIG_KEYS.BUTTON_TEXT]: 'Submit', [BUTTON_CONFIG_KEYS.BUTTON_TYPE]: 'submit' }
+ *   ]);
+ *
+ * Or using regular object keys:
+ *   cy.validateFormFooterButtons([
+ *     { buttonText: 'Cancel' },
+ *     { buttonText: 'Reset', shouldBeDisabled: true },
+ *     { buttonText: 'Submit', buttonType: 'submit' }
+ *   ]);
+ *
+ * Both approaches work but using config-keys object(BUTTON_CONFIG_KEYS) is recommended to avoid typos and unknown keys
+ */
+Cypress.Commands.add('validateFormFooterButtons', (buttonConfigs) => {
+  if (!Array.isArray(buttonConfigs)) {
+    cy.logAndThrowError('buttonConfigs must be an array');
+  }
+
+  if (!buttonConfigs.length) {
+    cy.logAndThrowError('buttonConfigs array cannot be empty');
+  }
+
+  buttonConfigs.forEach((config) => {
+    validateConfigKeys(config, BUTTON_CONFIG_KEYS, 'button');
+
+    const buttonText = config[BUTTON_CONFIG_KEYS.BUTTON_TEXT];
+    const buttonType = config[BUTTON_CONFIG_KEYS.BUTTON_TYPE] || 'button';
+    const shouldBeDisabled =
+      config[BUTTON_CONFIG_KEYS.SHOULD_BE_DISABLED] || false;
+
+    if (!buttonText) {
+      cy.logAndThrowError(
+        `${BUTTON_CONFIG_KEYS.BUTTON_TEXT} is required for each button config`
+      );
+    }
+
+    const buttonCheck = cy
+      .getFormFooterButtonByTypeWithText({
+        buttonText,
+        buttonType,
+      })
+      .should('be.visible');
+
+    if (shouldBeDisabled) {
+      buttonCheck.and('be.disabled');
+    } else {
+      buttonCheck.and('be.enabled');
+    }
+  });
+});