Added command to target form legend elements

Author: asirvadAbrahamVarghese

cypress/support/commands/element_selectors.js

@@ -67,6 +67,25 @@ Cypress.Commands.add('getFormLabelByForAttribute', ({ forValue }) => {
   return cy.get(`#main-content .bx--form label[for="${forValue}"]`);
 });
 
+/**
+ * Retrieves a form legend element by its text content.
+ *
+ * @param {Object} options - The options object.
+ * @param {string} options.legendText - The text content of the legend element (required).
+ * @returns {Element} The matched legend element.
+ * @throws {Error} If legendText is not provided.
+ *
+ * Example:
+ *   cy.getFormLegendByText({ legendText: 'Personal Information' });
+ *   cy.getFormLegendByText({ legendText: 'Payment Details' });
+ */
+Cypress.Commands.add('getFormLegendByText', ({ legendText }) => {
+  if (!legendText) {
+    cy.logAndThrowError('legendText is required');
+  }
+  return cy.contains('#main-content form legend.bx--label', legendText);
+});
+
 /**
  * Retrieves a form select field by its ID using an object parameter.
  *