froth-webdriverio-framework 7.0.118-uat1.2 → 7.0.119-dev1.0

package/froth_api_calls/browsersatckSessionInfo.js

@@ -212,6 +212,8 @@ async function updateBrowserStackReport(frothUrl, token, bsBuildId, executionId,
             data = await response.text();
         }
 
+        console.log('📥 Response in updateBrowserStackReport:', data);
+
         if (response.ok) {
             console.log(`✅ BrowserStack report updated successfully [${status}]`);
             return data;

package/froth_api_calls/getexecutionDetails.js

@@ -17,7 +17,9 @@ function isValidId(id) {
 async function handleResponse(response, context) {
 
     if (response.ok) {
-        return response.json();
+        const data = await response.json();
+        console.log('📥 Response in', context, ':', data);
+        return data;
     }
 
     if (response.status === 401) {
@@ -170,9 +172,7 @@ async function updateExecuitonDetails(frothUrl, token, id, resultdetails) {
             data = await response.text();
         }
 
-       // console.log('📤 API Response Status:', response.status);
-       // console.log('📤 API Response Headers:', Array.from(response.headers.entries()));
-       // console.log('📤 API Response Body:', data);
+        console.log('📥 Response from updateExecuitonDetails:', data);
 
         if (!response.ok) {
             console.error(`❌ Failed to update execution details, status ${response.status}`);

package/froth_common_actions/assert.js

@@ -1,5 +1,5 @@
 // Function to verify text in Android app
-import assert from 'assert';
+const assert = require('assert');
 const amendToBrowserstack = require("../froth_api_calls/browsersatckSessionInfo").amend2Browserstack;
 
 async function assertText(elementSelector, expectedText) {

package/froth_configs/base.config.js

@@ -4,6 +4,9 @@ console.log('====>SUITE_FILE:', SUITE_FILE);
 const { LocalStorage } = require('node-localstorage');
 global.BUFFER = new LocalStorage('./buffer_storage');
 
+// Make Util globally available across all test files
+global.Util = require('../froth_common_actions/Utils');
+
 module.exports = {
     specs: require(SUITE_FILE).tests,
     exclude: [],

package/froth_configs/commonhook.js

@@ -339,6 +339,8 @@ const commonHooks = {
   onComplete: async (exitCode, _, __, results) => {
     console.log('==== ON COMPLETE ====');
     console.log(`Total: ${results.total || 0}, Passed: ${results.passed || 0}, Failed: ${results.failed || 0}`);
+    //console.log("Exit code onComplete===>" + exitCode)
+
     if (exitCode === undefined || exitCode === null) {
       exitCode = 1   // treat as failure
     }

package/froth_configs/local/web.config.js

@@ -1,8 +1,58 @@
-module.exports = () => ({
-    services: ['chromedriver'],
+module.exports = (bsCaps) => {
+    const browserName = (bsCaps.browserName || 'chrome').toLowerCase();
+    //const browserVersion = bsCaps.browserVersion;
 
+    // Map browser names to their WebdriverIO services
+    const browserServiceMap = {
+        chrome: 'chromedriver',
+        firefox: 'geckodriver',
+        edge: 'edgedriver',
+        ie: 'iedriver',
+        'internet explorer': 'iedriver',
+        safari: 'safaridriver'
+    };
 
-    capabilities: [{
-        browserName: 'chrome'
-    }]
-});
+    const service = browserServiceMap[browserName] || 'chromedriver';
+
+    const config = {
+        services: [service]
+    };
+
+    // Add browser-specific capabilities
+    if (browserName === 'chrome') {
+        config.capabilities = [{
+            browserName: 'chrome',
+            'goog:chromeOptions': {
+               // args: browserVersion ? [`--version=${browserVersion}`] : []
+            }
+        }];
+    } else if (browserName === 'firefox') {
+        config.capabilities = [{
+            browserName: 'firefox',
+            'moz:firefoxOptions': {
+                // Add Firefox-specific options if needed
+            }
+        }];
+    } else if (browserName === 'edge') {
+        config.capabilities = [{
+            browserName: 'MicrosoftEdge'
+        }];
+    } else if (browserName === 'safari') {
+        config.capabilities = [{
+            browserName: 'safari'
+        }];
+    } else if (browserName === 'ie' || browserName === 'internet explorer') {
+        config.capabilities = [{
+            browserName: 'internet explorer'
+        }];
+    } else {
+        // Default to Chrome for unsupported browsers
+        config.capabilities = [{
+            browserName: 'chrome'
+        }];
+    }
+
+    console.log(`🌐 Local execution configured for: ${browserName}${browserVersion ? ` (v${browserVersion})` : ''} using service: ${service}`);
+
+    return config;
+};

package/package.json

@@ -1,6 +1,5 @@
-{
-  "name": "froth-webdriverio-framework",
-  "version": "7.0.118-uat1.2",
+{ "name": "froth-webdriverio-framework",
+  "version": "7.0.119-dev1.0",
   "readme": "WebdriverIO Integration",
   "description": "WebdriverIO and BrowserStack App Automate",
   "license": "MIT",
@@ -18,16 +17,17 @@
     "appium"
   ],
   "dependencies": {
-    "@wdio/appium-service": "^9.23.0",
-    "@wdio/browserstack-service": "^9.23.0",
-    "@wdio/cli": "^9.23.0",
-    "@wdio/local-runner": "^9.23.0",
-    "@wdio/mocha-framework": "^9.23.0",
+
+    "@wdio/appium-service": "9.23.0",
+    "@wdio/browserstack-service": "9.23.0",
+    "@wdio/cli": "9.23.0",
+    "@wdio/local-runner": "9.23.0",
+    "@wdio/mocha-framework": "9.23.0",
     "@wdio/spec-reporter": "^9.20.0",
     "appium": "^3.1.2",
     "appium-uiautomator2-driver": "^6.7.8",
     "assert": "^2.1.0",
-    "axios": "^1.13.2",
+    "axios": "1.14.0",
     "browserstack-local": "^1.5.8",
     "chai": "^6.2.2",
     "crypto-js": "^4.2.0",
@@ -44,6 +44,8 @@
     "randexp": "^0.5.3",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3",
+
     "vm": "^0.1.0"
+
   }
-}
+}

package/CLAUDE.md

@@ -1,215 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-**Version:** 9.0.5-ytlc
-
-**Repository:** https://github.com/RoboticoDigitalProjects/froth-webdriverio.git
-
-This is a WebdriverIO test automation framework (FROTH - "froth-webdriverio-framework") that supports web, Android, and iOS testing on both BrowserStack and local environments. The framework integrates with a Froth TestOps backend API for execution tracking, reporting, and test data management.
-
-## Commands
-
-### Running Tests
-
-Tests are run using the WebdriverIO CLI with platform-specific configurations. Note: Configuration files (`android.conf.js`, `web.conf.js`, etc.) must be created at the root level to reference `froth_configs/wdio.common.conf.js`:
-
-```bash
-# Android tests
-npx wdio ./android.conf.js
-
-# Web tests
-npx wdio ./web.conf.js
-
-# iOS tests
-npx wdio ./ios.conf.js
-
-# Lint code
-npm run lint
-```
-
-### Creating Configuration Files
-
-Platform-specific config files must be created at the root level. Example `android.conf.js`:
-
-```javascript
-exports.config = require('./froth_configs/wdio.common.conf').config;
-```
-
-### Generating Allure Reports
-
-Allure reports are generated manually using the Allure CLI:
-
-```bash
-# Android reports
-allure generate ./mobile/androidReports/allure-results --clean && allure open
-
-# iOS reports
-allure generate ./mobile/iosReports/allure-results --clean && allure open
-
-# Web reports
-allure generate ./webReports/allure-results --clean && allure open
-```
-
-### Running Tests
-
-Tests are run by specifying environment variables and the config file:
-
-```bash
-SUITE=./android_suites/samplesuite_x.js \
-YML_NAME=./ymls/browserstack/android/android_pixel8.yml \
-PLATFORM=browserstack \
-EXECUTION_ID=123 \
-API_TOKEN=your_token \
-ORGANISATION_DOMAIN_URL=https://devapi.frothtestops.com \
-npx wdio ./android.conf.js
-```
-
-## Architecture
-
-### Configuration Hierarchy
-
-The framework uses a multi-layered configuration system:
-
-1. **Base Configuration** (`froth_configs/base.config.js`): Contains framework settings, specs path, timeouts, and Mocha options. Initializes a global `BUFFER` using `node-localstorage` for cross-module state sharing.
-
-2. **Common Configuration** (`froth_configs/wdio.common.conf.js`): Acts as the entry point. It:
-   - Loads capabilities from a YAML file specified by `YML_NAME`
-   - Decodes BrowserStack credentials from base64
-   - Determines platform (web vs mobile) based on `platformName` in capabilities
-   - Merges base config with platform-specific config
-
-3. **Platform-Specific Configs** (`froth_configs/browserstack/` and `froth_configs/local/`):
-   - `web.config.js`: BrowserStack web testing configuration
-   - `mobile.config.js`: BrowserStack mobile (Android/iOS) testing configuration
-   - Supports `BS_UPLOAD_MEDIA` for injecting media files into tests
-
-### Test Lifecycle and Hooks
-
-All test lifecycle hooks are defined in `froth_configs/commonhook.js`:
-
-- **onPrepare**: Initializes environment variables, execution details, suite details, and test data via `setallDatailinBuffer.js`. Registers global error handlers.
-- **beforeSession**: Validates test syntax, configures BrowserStack capabilities, sets app path for mobile testing
-- **beforeSuite**: Fetches BrowserStack session details, updates CICD run ID
-- **beforeTest/afterTest**: Updates individual script execution status via API
-- **afterSession**: Calculates total execution time, updates final execution status
-- **onComplete**: Clears the BUFFER storage
-
-### Directory Structure
-
-```
-froth_common_actions/     # Reusable test utilities and actions
-  ├── Utils.js            # Central export point for all utilities
-  ├── scroll.js           # Scrolling helpers (scrollToEnd, scrollDownToView, etc.)
-  ├── swipe.js            # Gesture helpers (swipeUp, swipeDown, swipeWithCoordinates)
-  ├── click.js            # Click helpers (clickIfVisible, doubleClick)
-  ├── assert.js           # Assertion helpers (assertText, assertAttributeValue)
-  ├── random.js           # Random data generators (RANDOMTEXT, RNDNUMBER, etc.)
-  ├── storeToBuffer.js    # Buffer storage helpers for runtime data
-  ├── dbValidator.js      # Database field validation
-  └── ...                 # Other common actions
-
-froth_api_calls/          # API integration layer
-  ├── loginapi.js         # Authentication token retrieval
-  ├── getexecutionDetails.js   # Fetch/update execution details via TestOps API
-  ├── getsuiteDetails.js  # Fetch test suite and script mappings
-  ├── readTestdata.js     # Fetch test data by ID
-  └── browsersatckSessionInfo.js # BrowserStack session management
-
-froth_configs/            # Configuration files
-  ├── base.config.js
-  ├── wdio.common.conf.js
-  ├── commonhook.js
-  ├── setallDatailinBuffer.js
-  ├── browserstack/       # BrowserStack-specific configs
-  └── local/              # Local execution configs
-
-android/                  # Android test scripts
-android_suites/           # Android suite definitions (array of test files)
-web/                      # Web test scripts
-web_suites/               # Web suite definitions
-ymls/browserstack/        # Capability YAML files for different devices/browsers
-```
-
-### Test Data Flow
-
-1. Environment variables are loaded in `setallDatailinBuffer.js` during `onPrepare`
-2. Global state is stored in `BUFFER` (node-localstorage at `./buffer_storage`)
-3. Execution details are fetched from the Froth TestOps API
-4. Test scripts access data via `BUFFER.getItem()` / `BUFFER.setItem()`
-5. Results are posted back to the API via `updateScriptExecutionStatus` and `updateExecuitonDetails`
-
-### Test Suite Pattern
-
-Suites are defined as simple modules exporting a `tests` array:
-
-```javascript
-// Example: android_suites/samplesuite_x.js
-module.exports = {
-    tests: [
-        '/absolute/path/to/android/test_script.js'
-    ]
-};
-```
-
-### Common Actions Usage
-
-Tests import utilities from the Utils export:
-
-```javascript
-const Util = require('../froth_common_actions/Utils');
-
-// Scrolling
-await Util.scrollToEnd(2, 3);
-await Util.scrollDownToView("Some Text");
-
-// Swiping
-await Util.swipeWithCoordinates(x1, y1, x2, y2);
-
-// Random data
-const randomText = Util.randomtext(10);
-const randomNumber = Util.randomnumber(100, 999);
-
-// Buffer storage
-Util.storetext('key', 'value');
-const value = BUFFER.getItem('key');
-```
-
-## Required Environment Variables
-
-| Variable | Description | Example |
-|----------|-------------|---------|
-| `YML_NAME` | Path to capability YAML file | `./ymls/browserstack/android/android_pixel8.yml` |
-| `SUITE` | Path to suite file | `./android_suites/samplesuite_x.js` |
-| `PLATFORM` | `browserstack`, `browserstacklocal`, or omitted for local | `browserstack` |
-| `EXECUTION_ID` | Test execution ID from TestOps | `123` |
-| `API_TOKEN` | Authentication token for TestOps API | `eyJhbG...` |
-| `ORGANISATION_DOMAIN_URL` | Froth TestOps API base URL | `https://devapi.frothtestops.com` |
-| `CICD_RUN_ID` | CI/CD pipeline run ID (optional) | `build-456` |
-| `BS_UPLOAD_MEDIA` | Comma-separated media URLs for BrowserStack (optional) | `url1,url2` |
-
-## Capability YAML Format
-
-YAML files define device/browser capabilities. Example for Android:
-
-```yaml
-userName: "bs_username"
-accessKey: "base64_encoded_key"
-platformName: "Android"
-deviceName: "Samsung Galaxy S22 Ultra"
-platformVersion: "12.0"
-debug: true
-networkLogs: true
-interactiveDebugging: false
-```
-
-## Important Notes
-
-- The framework uses `node-localstorage` to create a global `BUFFER` accessible across all modules
-- All API responses from TestOps are AES-decrypted via `aesEncryptionDecryption.js`
-- Test scripts map to TestOps via filename (script name must match `scriptName` in suite details)
-- Mobile tests use Appium selectors like `id:com.example:id/elementId` and `-android uiautomator:...`
-- Web tests use standard WebdriverIO selectors (`$`, `$$`)
-- Framework supports both BrowserStack App Automate (mobile) and Automate (web) sessions