@zohodesk/testinglibrary 0.4.81-n18-experimental → 0.4.83-n18-experimental

package/README.md

@@ -12,12 +12,68 @@
   ### Run TestCase
 
     - npm run test
+
   ### Generate Report
 
      - npm run report
 
 ## Version History
 
+### v3.2.6 - 02-09-2025
+
+#### Feature
+
+  - Multi-actor execution support – now possible to switch between multiple profile agents within scenarios using the new `actorCtx` custom fixture.
+
+### v3.2.5 - 28-08-2025
+
+#### Enhancement
+
+  - Removed the searchFake dependency from the project level and adopted it inside the framework, reducing project-side maintenance.
+
+### v3.2.4 - 29-07-2025
+
+#### Feature
+  - Data Generator steps are now supported directly via the framework.
+
+### Bug fix
+  - Feature File Root Directory not found issue fixed
+
+### v3.2.3 - 29-07-2025
+
+#### Feature
+  - Added support for running Smoke Tests in the UAT stage.
+
+### v3.2.0 - 22-06-2025
+
+#### Feature
+  - Default required spec files are now auto-imported from the library into the project.
+
+### v3.1.13 - 02-07-2025
+
+#### Enhancement
+  - Below package versions are updated in this release.
+    - @cucumber/Cucumber - 11.3.0
+    - Playwright/test - 1.53.2
+    - Playwright - 1.53.2
+    - Playwright-bdd - 8.3.1
+  - QC custom reporter changes have been adopted into the framework.
+
+### v3.1.5 - 22-05-2025
+
+#### Feature
+  - Added support for Module Based Execution UAT stage.
+
+### v3.1.4 - 12-05-2025
+
+#### Enhancement
+  - Playwright version 1.52.0 adopted in testing framework
+
+### v3.1.3 - 25-04-2025
+
+#### Enhancement
+  - Playwright version 1.51.0 adopted in testing framework
+
 ### v0.2.8 - 26-09-2024
 
 #### Feature
@@ -27,8 +83,6 @@
   - Updated the custom-reported to include the errors in tests during the executions. It will help us avoid the stage passed without the actual test execution. 
 
 
-## Version History
-
 ### v3.0.8 - 25-12-2024
 
 #### Enhancement

package/build/common/multi-actor/steps/additionalContext.spec.js

@@ -0,0 +1,36 @@
+"use strict";
+
+var _testinglibrary = require("@zohodesk/testinglibrary");
+const {
+  BeforeScenario,
+  Given
+} = (0, _testinglibrary.createBdd)();
+BeforeScenario(async function ({
+  actorCtx,
+  page,
+  context,
+  browser,
+  executionContext
+}) {
+  // This will run before each scenario and set all the fixtures into this context
+  this.page = page;
+  this.context = context;
+  this.browser = browser;
+  this.executionContext = executionContext;
+  this.setActor = async role => {
+    const userPage = actorCtx.userPages.find(up => up.role === role);
+    if (userPage) {
+      this.page = userPage.page;
+      this.context = userPage.context;
+      this.browser = userPage.browser;
+      this.executionContext = userPage.actorInfo;
+    } else {
+      throw new Error(`Actor ${role} not found`);
+    }
+  };
+});
+Given("switch to {string} profile user page", async function ({
+  page
+}, userRole) {
+  await this.setActor(userRole);
+});

package/build/core/playwright/builtInFixtures/actorCtx.js

@@ -0,0 +1,88 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _logger = require("../../../utils/logger");
+var _customFixturesHelper = require("../helpers/customFixturesHelper");
+class actorContext {
+  constructor() {
+    this.page = null;
+    this.browser = null;
+    this.context = null;
+    this.actorInfo = null;
+    this.userPages = [];
+    this.actorsList = {};
+  }
+  async setupAllActors(browser, $tags, testInfo, defaultPage, defaultContext) {
+    const actorInfoMap = (0, _customFixturesHelper.getCustomAccountDetails)($tags);
+    await Promise.all(Object.entries(actorInfoMap).map(async ([role, actorInfo], index) => {
+      let context, page;
+      if (index === 0) {
+        context = defaultContext;
+        page = defaultPage;
+      } else {
+        context = await browser.newContext();
+        page = await context.newPage();
+      }
+      let ctxTestDetails = {
+        page,
+        $tags,
+        context,
+        ...actorInfo
+      };
+      await (0, _customFixturesHelper.executeDefaultLoginSteps)(context, testInfo, ctxTestDetails, actorInfo);
+      this.actorsList[role] = {
+        role,
+        browser,
+        context,
+        page,
+        actorInfo,
+        isPrimary: index === 0
+      };
+      await this.addUserPage(role, browser, page, context, actorInfo);
+    }));
+    for (const actorObj of Object.values(this.actorsList)) {
+      await (0, _customFixturesHelper.performDefaultPageSteps)({
+        context: actorObj.context,
+        page: actorObj.page,
+        $tags,
+        ...actorObj.actorInfo
+      });
+    }
+  }
+  async addUserPage(role, browser, page, context, actorInfo) {
+    this.userPages.push({
+      role,
+      browser,
+      page,
+      context,
+      actorInfo
+    });
+  }
+  async cleanup() {
+    for (const actor of Object.values(this.actorsList)) {
+      if (!actor.isPrimary && actor.context) {
+        try {
+          await actor.context.close();
+        } catch (error) {
+          _logger.Logger.log(_logger.Logger.FAILURE_TYPE, `Failed to close context for actor ${actor.role}:`, error);
+        }
+      }
+    }
+  }
+}
+var _default = exports.default = {
+  actorCtx: async ({
+    $tags,
+    browser,
+    context,
+    page
+  }, use, testInfo) => {
+    const ctxObject = new actorContext();
+    await ctxObject.setupAllActors(browser, $tags, testInfo, page, context);
+    await use(ctxObject);
+    await ctxObject.cleanup();
+  }
+};

package/build/core/playwright/builtInFixtures/executionContext.js

@@ -4,14 +4,14 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var _page = require("./page");
+var _customFixturesHelper = require("../helpers/customFixturesHelper");
 var _default = exports.default = {
   executionContext: async ({
     $tags
   }, use) => {
-    let testPortalActorDetails = {
-      actorInfo: (0, _page.getCustomAccountDetails)($tags)
-    };
-    await use(testPortalActorDetails);
+    const actorInfo = (0, _customFixturesHelper.getCustomAccountDetails)($tags);
+    await use({
+      actorInfo
+    });
   }
 };

package/build/core/playwright/builtInFixtures/index.js

@@ -12,12 +12,14 @@ var _addTags = _interopRequireDefault(require("./addTags"));
 var _i18N = _interopRequireDefault(require("./i18N"));
 var _unauthenticatedPage = _interopRequireDefault(require("./unauthenticatedPage"));
 var _executionContext = _interopRequireDefault(require("./executionContext"));
+var _actorCtx = _interopRequireDefault(require("./actorCtx"));
 function extractTagsFromTitle(text) {
   return text.match(/@\w+/g) || [];
 }
 function getBuiltInFixtures(bddMode) {
   let builtInFixtures = {
     ..._page.default,
+    ..._actorCtx.default,
     ..._context.default,
     ..._cacheLayer.default,
     ..._i18N.default,

package/build/core/playwright/builtInFixtures/page.js

@@ -4,58 +4,8 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-exports.getCustomAccountDetails = getCustomAccountDetails;
-var _auth = require("../helpers/auth");
-var _readConfigFile = require("../readConfigFile");
+var _customFixturesHelper = require("../helpers/customFixturesHelper");
 /* eslint-disable global-require */
-
-//import { additionProfiles } from '../helpers/additionalProfiles';
-
-function getTagInputFromSelectedTags(tags, inputString) {
-  const selectedTag = [...tags].reverse().find(tag => tag.startsWith(inputString));
-  let tagInput = null;
-  if (selectedTag) {
-    tagInput = selectedTag.split(`${inputString}_`).pop().toLowerCase();
-  }
-  return tagInput;
-}
-function getCustomAccountDetails(tags) {
-  const tagsTobeFiltered = ['@profile', '@edition', '@beta', '@portal', '@additional_profile'];
-  const filteredTags = tags.filter(tag => tagsTobeFiltered.some(prefix => tag.startsWith(prefix)));
-  if (filteredTags && filteredTags.length > 0) {
-    const portalInfo = getTagInputFromSelectedTags(filteredTags, '@portal');
-    const betaFeature = getTagInputFromSelectedTags(filteredTags, '@beta');
-    const profileInfo = getTagInputFromSelectedTags(filteredTags, '@profile');
-    const editionInfo = getTagInputFromSelectedTags(filteredTags, '@edition');
-    const user = (0, _auth.getUserForSelectedEditionAndProfile)(editionInfo, profileInfo, betaFeature, portalInfo);
-    return user;
-  }
-  return (0, _auth.getDefaultActor)();
-}
-const {
-  testSetup
-} = (0, _readConfigFile.generateConfigFromFile)();
-async function loginSteps(pageDetail) {
-  const {
-    page
-  } = pageDetail;
-  if (testSetup.loginSteps && typeof testSetup.loginSteps === 'function') {
-    return await testSetup.loginSteps(pageDetail);
-  } else {
-    await page.goto(process.env.domain);
-  }
-}
-async function performDefaultPageSteps(testInfo) {
-  if (testSetup.page && typeof testSetup.page === 'function') {
-    await testSetup.page(testInfo);
-  }
-}
-async function verifyPageIsLoaded(testInfo) {
-  if (testSetup.validateLogin && typeof testSetup.validateLogin === 'function') {
-    return await testSetup.validateLogin(testInfo);
-  }
-  return true;
-}
 var _default = exports.default = {
   page: async ({
     context,
@@ -63,7 +13,7 @@ var _default = exports.default = {
     page,
     executionContext
   }, use, testInfo) => {
-    let testPortalDetails = executionContext.actorInfo;
+    let testPortalDetails = executionContext.actorInfo[Object.keys(executionContext.actorInfo)[0]];
     let testDetails = {
       page,
       $tags,
@@ -76,24 +26,11 @@ var _default = exports.default = {
         await context.clearCookies();
         return;
       }
-      const {
-        isAuthMode
-      } = (0, _readConfigFile.generateConfigFromFile)();
-      if (!isAuthMode) {
-        return;
-      }
-      const projectName = testInfo.project.name;
-      if (testPortalDetails && projectName !== 'setup' && projectName !== 'cleanup') {
-        await context.clearCookies();
-        await (0, _auth.performLoginSteps)(testDetails, async testInfo => {
-          return await verifyPageIsLoaded(testInfo);
-        }, loginSteps);
-        process.env.actorInfo = JSON.stringify(testPortalDetails);
-      }
+      await (0, _customFixturesHelper.executeDefaultLoginSteps)(context, testInfo, testDetails, testPortalDetails);
     } catch (e) {
       console.error('Error during page', e);
     } finally {
-      await performDefaultPageSteps(testDetails);
+      await (0, _customFixturesHelper.performDefaultPageSteps)(testDetails);
       await use(page);
       await context.close();
     }

package/build/core/playwright/helpers/customFixturesHelper.js

@@ -0,0 +1,91 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.executeDefaultLoginSteps = executeDefaultLoginSteps;
+exports.getCustomAccountDetails = getCustomAccountDetails;
+exports.loginSteps = loginSteps;
+exports.performDefaultPageSteps = performDefaultPageSteps;
+exports.verifyPageIsLoaded = verifyPageIsLoaded;
+var _auth = require("../helpers/auth");
+var _additionalProfiles = require("../helpers/additionalProfiles");
+var _readConfigFile = require("../readConfigFile");
+var _logger = require("../../../utils/logger");
+/* eslint-disable global-require */
+
+let {
+  testSetup,
+  isAuthMode
+} = (0, _readConfigFile.generateConfigFromFile)();
+function getTagInputFromSelectedTags(tags, inputString) {
+  const selectedTag = [...tags].reverse().find(tag => tag.startsWith(inputString));
+  let tagInput = null;
+  if (selectedTag) {
+    tagInput = selectedTag.split(`${inputString}_`).pop().toLowerCase();
+  }
+  return tagInput;
+}
+function getCustomAccountDetails(tags) {
+  const tagsTobeFiltered = ['@profile', '@edition', '@beta', '@portal', '@additional_profile'];
+  const filteredTags = tags.filter(tag => tagsTobeFiltered.some(prefix => tag.startsWith(prefix)));
+  if (filteredTags && filteredTags.length > 0) {
+    const portalInfo = getTagInputFromSelectedTags(filteredTags, '@portal');
+    const betaFeature = getTagInputFromSelectedTags(filteredTags, '@beta');
+    const profileInfo = getTagInputFromSelectedTags(filteredTags, '@profile');
+    const editionInfo = getTagInputFromSelectedTags(filteredTags, '@edition');
+    const defaultActor = (0, _auth.getUserForSelectedEditionAndProfile)(editionInfo, profileInfo, betaFeature, portalInfo);
+    const actors = {
+      [defaultActor.profile]: defaultActor
+    };
+    const additionalProfileActors = (0, _additionalProfiles.additionProfiles)(tags, editionInfo, betaFeature, portalInfo);
+    const additionalProfileTags = tags.filter(tag => tag.startsWith('@additional_profile_'));
+    additionalProfileTags.forEach((tag, index) => {
+      const profileName = tag.replace('@additional_profile_', '');
+      actors[`${profileName}`] = additionalProfileActors[index];
+    });
+    return actors;
+  }
+  const actiorInfoDetail = (0, _auth.getDefaultActor)();
+  return {
+    [actiorInfoDetail.profile]: actiorInfoDetail
+  };
+}
+async function loginSteps(pageDetail) {
+  const {
+    page
+  } = pageDetail;
+  if (testSetup.loginSteps && typeof testSetup.loginSteps === 'function') {
+    return await testSetup.loginSteps(pageDetail);
+  } else {
+    await page.goto(process.env.domain);
+  }
+}
+async function performDefaultPageSteps(testInfo) {
+  if (testSetup.page && typeof testSetup.page === 'function') {
+    await testSetup.page(testInfo);
+  }
+}
+async function verifyPageIsLoaded(testInfo) {
+  if (testSetup.validateLogin && typeof testSetup.validateLogin === 'function') {
+    return await testSetup.validateLogin(testInfo);
+  }
+  return true;
+}
+async function executeDefaultLoginSteps(context, testInfo, testDetails, testPortalDetails) {
+  if (!isAuthMode) {
+    return;
+  }
+  try {
+    const projectName = testInfo.project.name;
+    if (testPortalDetails && projectName !== 'setup' && projectName !== 'cleanup') {
+      await context.clearCookies();
+      await (0, _auth.performLoginSteps)(testDetails, async testInfo => {
+        return await verifyPageIsLoaded(testInfo);
+      }, loginSteps);
+      process.env.actorInfo = JSON.stringify(testPortalDetails);
+    }
+  } catch (error) {
+    _logger.Logger.log(_logger.Logger.FAILURE_TYPE, 'Error while executing the default login steps:', error);
+  }
+}

package/build/setup-folder-structure/samples/settings.json

@@ -2,6 +2,6 @@
   "environment": "dev",
   "edition": "enterprise",
   "profile": "admin",
-  "domain": "https://zdesk-devops16.csez.zohocorpin.com:31025/agent",
+  "domain": "https://zdesk-devops25.csez.zohocorpin.com:31037/agent",
   "devUrl" : "" 
 }

package/build/test/core/playwright/buildInFixtures/__tests__/executionContext.test.js

@@ -1,9 +1,9 @@
 "use strict";
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-var _page = require("../../../../../core/playwright/builtInFixtures/page");
+var _customFixturesHelper = require("../../../../../core/playwright/helpers/customFixturesHelper");
 var _executionContext = _interopRequireDefault(require("../../../../../core/playwright/builtInFixtures/executionContext"));
-jest.mock('../../../../../core/playwright/builtInFixtures/page');
+jest.mock('../../../../../core/playwright/helpers/customFixturesHelper');
 describe('executionContext', () => {
   test('should pass actorInfo with details from getCustomAccountDetails to use', async () => {
     const mockTags = ['tag1', 'tag2'];
@@ -14,12 +14,12 @@ describe('executionContext', () => {
       profile: 'admin',
       email: 'xxx.x+uat@zohotest.com'
     };
-    _page.getCustomAccountDetails.mockReturnValue(mockActorInfo);
+    _customFixturesHelper.getCustomAccountDetails.mockReturnValue(mockActorInfo);
     const use = jest.fn();
     await _executionContext.default.executionContext({
       $tags: mockTags
     }, use);
-    expect(_page.getCustomAccountDetails).toHaveBeenCalledWith(mockTags);
+    expect(_customFixturesHelper.getCustomAccountDetails).toHaveBeenCalledWith(mockTags);
     expect(use).toHaveBeenCalledWith({
       actorInfo: mockActorInfo
     });