Add interceptApi command to prevent duplicate intercept aliases

Author: asirvadAbrahamVarghese

cypress/support/commands/api_commands.js

@@ -0,0 +1,44 @@
+/* eslint-disable no-undef */
+
+/**
+ * Custom command to intercept API calls and wait for them to complete.
+ * This command will:
+ * 1. Register an intercept for the given alias and URL pattern if not already registered
+ * 2. Execute the trigger function that makes the API call
+ * 3. Wait for the intercepted request to complete if it was triggered
+ *
+ * @param {Object} options - The options for the intercept
+ * @param {string} options.alias - Unique alias for this interception
+ * @param {string} options.method - HTTP method (default: 'POST')
+ * @param {string|RegExp} options.urlPattern - URL pattern to intercept
+ * @param {Function} options.triggerFn - Function that triggers the API call
+ */
+Cypress.Commands.add(
+  'interceptApi',
+  ({ alias, method = 'POST', urlPattern, triggerFn }) => {
+    /* ===== TODO: Remove this block once interceptApi command becomes stable ===== */
+    const envVars = Cypress.env();
+    cy.log('Cypress Environment Variables:');
+    cy.log(JSON.stringify(envVars, null, 2));
+    /* ======================================================= */
+
+    // Check if this request is already registered
+    const isAlreadyRegistered = !!Cypress.env('interceptedAliases')[alias];
+
+    // Register the intercept if not already done
+    if (!isAlreadyRegistered) {
+      cy.intercept(method, urlPattern).as(alias);
+
+      // Store the alias in the tracking object
+      const interceptedAliases = Cypress.env('interceptedAliases');
+      interceptedAliases[alias] = alias;
+      Cypress.env('interceptedAliases', interceptedAliases);
+    }
+
+    // Execute the function that triggers the API call
+    triggerFn();
+
+    // Wait for the intercepted request to complete
+    cy.wait(`@${alias}`);
+  }
+);

cypress/support/e2e.js

@@ -40,6 +40,7 @@
 // ***********************************************************
 
 // Commands
+import './commands/api_commands.js';
 import './commands/custom_logging_commands.js';
 import './commands/element_selectors.js';
 import './commands/explorer.js';
@@ -76,4 +77,7 @@ beforeEach(() => {
   // Global hook run once before each test
   // cy.throttle_response(500, 56);
   // cy.stub_notifications();
+  
+  // Reset the intercepted aliases tracking object
+  Cypress.env('interceptedAliases', {});
 })