lexxit-automation-framework 2.0.20 → 3.0.0

package/src/actions/radiobuttonHandler.ts

@@ -0,0 +1,286 @@
+import { Page } from 'playwright';
+import { ScreenshotMode, StepResult } from '../types/types';
+import { LocatorService } from '../utils/locatorService';
+import { BaseHandler } from './baseHandler';
+import { DEFAULT_SCREENSHOT_MODE } from '../config';
+
+export class RadiobuttonHandler extends BaseHandler {
+    protected page: Page;
+
+ constructor(page: Page, screenshotMode: ScreenshotMode = DEFAULT_SCREENSHOT_MODE) {
+  super();
+  this.page = page;
+  this.screenshotMode = screenshotMode;
+  this.setupNetworkCapture(page);
+}
+
+  // ─── Helpers ───────────────────────────────────────────────────────────────
+
+  // private getStartTime(): string {
+  //   return new Date().toISOString();
+  // }
+
+  // private getDuration(startMs: number): number {
+  //   return Date.now() - startMs;
+  // }
+
+  // private buildResult(
+  //   status: 'PASS' | 'FAIL',
+  //   expected_result: string,
+  //   comments: string,
+  //   startMs: number,
+  //   startTime: string,
+  //   step_name: string = '',
+  //   uid: string | null = null,
+  //   obj_uid: string | null = null,
+  //   page_uid: string | null = null
+  // ): StepResult {
+  //   return {
+  //     uid,
+  //     obj_uid,
+  //     page_uid,
+  //     step_name,
+  //     step_script: '',
+  //     status,
+  //     expected_result,
+  //     comments,
+  //     duration:   this.getDuration(startMs),
+  //     start_time: startTime
+  //   };
+  // }
+
+  // private async captureScreenshot(isFailure: boolean): Promise<string | undefined> {
+  //   if (this.screenshotMode === 'never') return undefined;
+  //   if (this.screenshotMode === 'on_failure' && !isFailure) return undefined;
+  //   try {
+  //     if (!this.page || this.page.isClosed()) return undefined;
+  //     const buf = await this.page.screenshot({ type: 'png', fullPage: false });
+  //     return buf.toString('base64');
+  //   } catch {
+  //     return undefined;
+  //   }
+  // }
+
+  // private classifyError(error: any): string {
+  //   const msg: string = error?.message || String(error);
+
+  //   if (msg.includes('Element not found') || msg.includes('not visible')) {
+  //     return `Element not found or not visible: ${msg}`;
+  //   }
+  //   if (msg.includes('Timeout') || msg.includes('timeout')) {
+  //     return `Timeout error - element took too long to respond: ${msg}`;
+  //   }
+  //   if (msg.includes('not enabled')) {
+  //     return `Element is disabled: ${msg}`;
+  //   }
+  //   if (msg.includes('detached')) {
+  //     return `Element got detached from DOM: ${msg}`;
+  //   }
+  //   if (msg.includes('Target closed') || msg.includes('has been closed')) {
+  //     return `Browser or page closed unexpectedly: ${msg}`;
+  //   }
+
+  //   return `Unexpected error: ${msg}`;
+  // }
+
+  // private appendMatchedLocatorInfo(comments: string, matchedIndex: number, matchedXPath: string): string {
+  //   if (matchedIndex > 0) {
+  //     return `${comments} (Matched locator at position ${matchedIndex}: ${matchedXPath})`;
+  //   }
+  //   return comments;
+  // }
+
+  // ─── select ────────────────────────────────────────────────────────────────
+
+  async select(label: string, locators: string[], step_name: string = 'Select radio button'): Promise<StepResult> {
+    const startMs = Date.now();
+    const startTime = this.getStartTime();
+    const expected = `'${label}' selected successfully`;
+
+    try {
+      const resolved = await LocatorService.resolveElement(this.page, locators);
+      await resolved.element.check();
+
+      const comments = this.appendMatchedLocatorInfo(expected, resolved.matchedIndex, resolved.matchedXPath);
+      return this.buildResult('PASS', expected, comments, startMs, startTime, step_name);
+    } catch (error: any) {
+      // const sc = await this.captureScreenshot(true);
+      return this.buildResult('FAIL', expected, this.classifyError(error), startMs, startTime, step_name);
+    }
+  }
+
+  // ─── selectByValue ─────────────────────────────────────────────────────────
+
+  async selectByValue(label: string, locators: string[], value: string, step_name: string = 'Select radio button by value'): Promise<StepResult> {
+    const startMs = Date.now();
+    const startTime = this.getStartTime();
+    const expected = `'${label}' option with value '${value}' selected successfully`;
+
+    try {
+      const combinedXPath = locators.join(' | ');
+      const allRadios = this.page.locator(`xpath=${combinedXPath}`);
+      const count = await allRadios.count();
+
+      if (count <= 1) {
+        const resolved = await LocatorService.resolveElement(this.page, locators);
+        await resolved.element.check();
+        const comments = this.appendMatchedLocatorInfo(expected, resolved.matchedIndex, resolved.matchedXPath);
+        return this.buildResult('PASS', expected, comments, startMs, startTime, step_name);
+      }
+
+      const targetByAttr = this.page.locator(`xpath=(${combinedXPath})[@value="${value}"]`).first();
+
+      const isVisible = await targetByAttr.isVisible().catch(() => false);
+      if (!isVisible) {
+        // const sc = await this.captureScreenshot(true);
+        return this.buildResult('FAIL', expected, `No radio option found with value '${value}' under label '${label}'`, startMs, startTime, step_name);
+      }
+
+      await targetByAttr.check();
+      return this.buildResult('PASS', expected, expected, startMs, startTime, step_name);
+    } catch (error: any) {
+      // const sc = await this.captureScreenshot(true);
+      return this.buildResult('FAIL', expected, this.classifyError(error), startMs, startTime, step_name);
+    }
+  }
+
+  // ─── selectByLabel ─────────────────────────────────────────────────────────
+
+  async selectByLabel(label: string, locators: string[], optionLabel: string, step_name: string = 'Select radio button by label'): Promise<StepResult> {
+    const startMs = Date.now();
+    const startTime = this.getStartTime();
+    const expected = `'${label}' option '${optionLabel}' selected successfully`;
+
+    try {
+      const combinedXPath = locators.join(' | ');
+      const allRadios = this.page.locator(`xpath=${combinedXPath}`);
+      const count = await allRadios.count();
+
+      if (count <= 1) {
+        const resolved = await LocatorService.resolveElement(this.page, locators);
+        await resolved.element.check();
+        const comments = this.appendMatchedLocatorInfo(expected, resolved.matchedIndex, resolved.matchedXPath);
+        return this.buildResult('PASS', expected, comments, startMs, startTime, step_name);
+      }
+
+      const targetByForId = this.page.locator(
+        `xpath=(${combinedXPath})[@id=//label[normalize-space(text())="${optionLabel}"]/@for]`
+      ).first();
+
+      let isVisible = await targetByForId.isVisible().catch(() => false);
+      let target = targetByForId;
+
+      if (!isVisible) {
+        const targetByWrapping = this.page.locator(
+          `xpath=(${combinedXPath})[ancestor::label[normalize-space(text())="${optionLabel}"]]`
+        ).first();
+        isVisible = await targetByWrapping.isVisible().catch(() => false);
+        target = targetByWrapping;
+      }
+
+      if (!isVisible) {
+        // const sc = await this.captureScreenshot(true);
+        return this.buildResult('FAIL', expected, `No radio option found with label text '${optionLabel}' under '${label}'`, startMs, startTime, step_name);
+      }
+
+      await target.check();
+      return this.buildResult('PASS', expected, expected, startMs, startTime, step_name);
+    } catch (error: any) {
+      // const sc = await this.captureScreenshot(true);
+      return this.buildResult('FAIL', expected, this.classifyError(error), startMs, startTime, step_name);
+    }
+  }
+
+  // ─── isSelected ────────────────────────────────────────────────────────────
+
+  async isSelected(label: string, locators: string[], step_name: string = 'Check if radio button is selected'): Promise<StepResult> {
+    const startMs = Date.now();
+    const startTime = this.getStartTime();
+    const expected = `'${label}' selected state retrieved successfully`;
+
+    try {
+      const resolved = await LocatorService.resolveElement(this.page, locators);
+      const checked = await resolved.element.isChecked();
+
+      const comments = this.appendMatchedLocatorInfo(
+        `'${label}' is ${checked ? 'selected' : 'not selected'}`,
+        resolved.matchedIndex,
+        resolved.matchedXPath
+      );
+      return this.buildResult('PASS', expected, comments, startMs, startTime, step_name);
+    } catch (error: any) {
+      // const sc = await this.captureScreenshot(true);
+      return this.buildResult('FAIL', expected, this.classifyError(error), startMs, startTime, step_name);
+    }
+  }
+
+  // ─── verifySelected ────────────────────────────────────────────────────────
+
+  async verifySelected(label: string, locators: string[], step_name: string = 'Verify radio button is selected'): Promise<StepResult> {
+    const startMs = Date.now();
+    const startTime = this.getStartTime();
+    const expected = `'${label}' is selected`;
+
+    try {
+      const resolved = await LocatorService.resolveElement(this.page, locators);
+      const checked = await resolved.element.isChecked();
+
+      if (!checked) {
+        const failComments = this.appendMatchedLocatorInfo(`'${label}' is not selected`, resolved.matchedIndex, resolved.matchedXPath);
+        return this.buildResult('FAIL', expected, failComments, startMs, startTime, step_name);
+      }
+
+      const comments = this.appendMatchedLocatorInfo(expected, resolved.matchedIndex, resolved.matchedXPath);
+      return this.buildResult('PASS', expected, comments, startMs, startTime, step_name);
+    } catch (error: any) {
+      // const sc = await this.captureScreenshot(true);
+      return this.buildResult('FAIL', expected, this.classifyError(error), startMs, startTime, step_name);
+    }
+  }
+
+  // ─── isEnabled ─────────────────────────────────────────────────────────────
+
+  async isEnabled(label: string, locators: string[], step_name: string = 'Check if radio button is enabled'): Promise<StepResult> {
+    const startMs = Date.now();
+    const startTime = this.getStartTime();
+    const expected = `'${label}' enabled state retrieved successfully`;
+
+    try {
+      const resolved = await LocatorService.resolveElement(this.page, locators);
+      const enabled = await resolved.element.isEnabled();
+
+      const comments = this.appendMatchedLocatorInfo(
+        `'${label}' is ${enabled ? 'enabled' : 'disabled'}`,
+        resolved.matchedIndex,
+        resolved.matchedXPath
+      );
+      return this.buildResult('PASS', expected, comments, startMs, startTime, step_name);
+    } catch (error: any) {
+      // const sc = await this.captureScreenshot(true);
+      return this.buildResult('FAIL', expected, this.classifyError(error), startMs, startTime, step_name);
+    }
+  }
+
+  // ─── isVisible ─────────────────────────────────────────────────────────────
+
+  async isVisible(label: string, locators: string[], step_name: string = 'Check if radio button is visible'): Promise<StepResult> {
+    const startMs = Date.now();
+    const startTime = this.getStartTime();
+    const expected = `'${label}' visibility state retrieved successfully`;
+
+    try {
+      const resolved = await LocatorService.resolveElement(this.page, locators);
+      const visible = await resolved.element.isVisible();
+
+      const comments = this.appendMatchedLocatorInfo(
+        `'${label}' is ${visible ? 'visible' : 'not visible'}`,
+        resolved.matchedIndex,
+        resolved.matchedXPath
+      );
+      return this.buildResult('PASS', expected, comments, startMs, startTime, step_name);
+    } catch (error: any) {
+      // const sc = await this.captureScreenshot(true);
+      return this.buildResult('FAIL', expected, this.classifyError(error), startMs, startTime, step_name);
+    }
+  }
+}