@enact/ui-test-utils 2.0.1 → 4.0.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Change Log
 
+## [4.0.0] (November 14, 2025)
+
+* Updated Chrome driver version to 132.
+
+## [3.0.0] (July 30, 2025)
+
+* Migrated to ESM
+
 ## [2.0.1] (July 18, 2025)
 
 * Updated dependencies.

package/README.md

@@ -9,29 +9,29 @@ and must be configured as a `devDependency` of the UI library.
 1. Add `@enact/ui-test-utils` as a devDependency: `npm i --save-dev @enact/ui-test-utils`
 2. Create the `tests/ui` folder structure within the UI library
 3. Add `apps` and `specs` folders to `tests/ui`
-4. Add local WebDriver configuration files within `tests/ui`
+4. Add local WebDriver configuration files within `tests/ui/config`
 
-    * `wdio.conf.js` containing `module.exports = require('@enact/ui-test-utils/ui/wdio.conf.js');`
-    * `wdio.docker.conf.js` containing `module.exports = require('@enact/ui-test-utils/ui/wdio.docker.conf.js');`
-    * `wdio.tv.conf.js` containing `module.exports = require('@enact/ui-test-utils/ui/wdio.tv.conf.js');`
+    * `wdio.conf.js` containing `import config from '@enact/ui-test-utils/ui/wdio.conf.js'; export default uiConfig;`
+    * `wdio.docker.conf.js` containing `import {uiDockerConfig} from '@enact/ui-test-utils/ui/wdio.docker.conf.js'; export default config;`
+    * `wdio.tv.conf.js` containing `import {uiTVConfig} from '@enact/ui-test-utils/ui/wdio.tv.conf.js'; export default config;`
 
-* and `tests/screenshot`
+* and `tests/screenshot/config`
 
-    * `wdio.conf.js` containing `module.exports = require('@enact/ui-test-utils/screenshot/wdio.conf.js');`
-    * `wdio.docker.conf.js` containing `module.exports = require('@enact/ui-test-utils/screenshot/wdio.docker.conf.js');`
-    * `wdio.tv.conf.js` containing `module.exports = require('@enact/ui-test-utils/screenshot/wdio.tv.conf.js');`
+    * `wdio.conf.js` containing `import config from '@enact/ui-test-utils/screenshot/wdio.conf.js'; export default ssConfig;`
+    * `wdio.docker.conf.js` containing `import {ssDockerConfig} from '@enact/ui-test-utils/screenshot/wdio.docker.conf.js'; export default config;`
+    * `wdio.tv.conf.js` containing `import {ssTVConfig} from '@enact/ui-test-utils/screenshot/wdio.tv.conf.js'; export default config;`
 
 5. Add npm scripts for each of the above configuration files. There are likely other scripts already
    defined so these will be added to the existing scripts.
 
 ```json
    "scripts": {
-      "test-ui": "start-tests tests/ui/wdio.conf.js",
-      "test-ui-docker": "start-tests tests/ui/wdio.docker.conf.js",
-      "test-ui-tv": "start-tests tests/ui/wdio.tv.conf.js",
-      "test-ss": "start-tests tests/screenshot/wdio.conf.js",
-      "test-ss-docker": "start-tests tests/screenshot/wdio.docker.conf.js",
-      "test-ss-tv": "start-tests tests/screenshot/wdio.tv.conf.js",
+      "test-ui": "start-tests tests/ui/config/wdio.conf.js",
+      "test-ui-docker": "start-tests tests/ui/config/wdio.docker.conf.js",
+      "test-ui-tv": "start-tests tests/ui/config/wdio.tv.conf.js",
+      "test-ss": "start-tests tests/screenshot/config/wdio.conf.js",
+      "test-ss-docker": "start-tests tests/screenshot/config/wdio.docker.conf.js",
+      "test-ss-tv": "start-tests tests/screenshot/config/wdio.tv.conf.js",
    }
 ```
 

package/config/wdio.conf.js

@@ -1,13 +1,11 @@
-const parseArgs = require('minimist');
-const {execSync} = require('child_process');
+import parseArgs from 'minimist';
 
 const args = parseArgs(process.argv);
 
 const visibleBrowser = !!args.visible,
-	maxInstances = args.instances || 5,
-	offline = args.offline;
+	maxInstances = args.instances || 5;
 
-module.exports.configure = (options) => {
+export const configure = (options) => {
 	const {base, services} = options;
 	const opts = Object.assign({}, options);
 
@@ -16,41 +14,8 @@ module.exports.configure = (options) => {
 	delete opts.services;
 
 	if (!process.env.CHROME_DRIVER) {
-		if (process.env.TV_IP && process.argv.find(arg => arg.includes('tv.conf'))) {
-			process.env.CHROME_DRIVER = 2.44; // Currently, TV supports 83 and lower, but keep the previous version for safety.
-		} else {
-			let chromeVersionMajorNumber;
-			try {
-				if (process.platform === 'win32') {
-					// Windows
-					const chromeVersion = /\d+/.exec(execSync('wmic datafile where "name=\'C:\\\\Program Files\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe\'" get Version /value').toString());
-					chromeVersionMajorNumber = (chromeVersion && chromeVersion[0]);
-				} else if (process.platform === 'darwin') {
-					// Mac
-					const chromeVersion = /Chrome (\d+)/.exec(execSync('/Applications/Google\\ Chrome.app/Contents/MacOS/Google\\ Chrome --version'));
-					chromeVersionMajorNumber = (chromeVersion && chromeVersion[1]);
-				} else {
-					const chromeVersion = /Chrome (\d+)/.exec(execSync('google-chrome -version'));
-					chromeVersionMajorNumber = (chromeVersion && chromeVersion[1]);
-				}
-				let chromeDriverVersion;
-
-				if (chromeVersionMajorNumber > 114) {
-					chromeDriverVersion = execSync('curl https://googlechromelabs.github.io/chrome-for-testing/LATEST_RELEASE' + (chromeVersionMajorNumber ? ('_' + chromeVersionMajorNumber) : ''));
-				} else {
-					chromeDriverVersion = execSync('curl https://chromedriver.storage.googleapis.com/LATEST_RELEASE' + (chromeVersionMajorNumber ? ('_' + chromeVersionMajorNumber) : ''));
-				}
-
-				if (chromeDriverVersion.includes('Error') || !/\d+.\d+.\d+.\d+/.exec(chromeDriverVersion)) {
-					throw new Error();
-				} else {
-					process.env.CHROME_DRIVER = chromeDriverVersion;
-				}
-			} catch (error) {
-				console.log('ERROR: Cannot find Chrome driver from Chrome ' + chromeVersionMajorNumber);
-				process.env.CHROME_DRIVER = 2.44;
-			}
-		}
+		// TODO: Update this version when chromedriver version in CI/CD is updated
+		process.env.CHROME_DRIVER = base === 'screenshot' ? '120.0.6099.109' : '132.0.6834.159';
 
 		console.log('Chrome Driver Version : ' + process.env.CHROME_DRIVER);
 	}
@@ -83,7 +48,7 @@ module.exports.configure = (options) => {
 			// the config file unless it's absolute.
 			//
 			specs: [
-				'../../tests/' + base + '/specs/**/*-specs.js'
+				'../../../tests/' + base + '/specs/**/*-specs.js'
 			],
 			// Patterns to exclude.
 			exclude: [
@@ -120,12 +85,31 @@ module.exports.configure = (options) => {
 				browserName: 'chrome',
 				/* WebdriverIO v8.14 and above downloads and uses the latest Chrome version when running tests.
 				We need to specify a browser version that matches chromedriver version running in CI/CD environment to
-				ensure testing accuracy.
-				TODO: Update this version when chromedriver version in CI/CD is updated */
-				browserVersion: '120.0.6099.109',
-				'goog:chromeOptions': visibleBrowser ? {} : {
-					args: ['--headless', '--window-size=1920,1080']
-				}
+				ensure testing accuracy. */
+				browserVersion: process.env.CHROME_DRIVER,
+				'goog:chromeOptions': visibleBrowser ?
+					{
+						args: [
+							'--disable-lcd-text',
+							'--force-device-scale-factor=1',
+							'--start-maximized',
+							'--start-fullscreen',
+							'--disable-gpu',
+							'--window-size=1920,1080'
+						]
+					} : {
+						args: [
+							'--disable-lcd-text',
+							'--force-device-scale-factor=1',
+							'--start-maximized',
+							'--start-fullscreen',
+							'--headless',
+							'--disable-gpu',
+							'--window-size=1920,1080'
+						]
+					},
+				webSocketUrl: false, // disables BiDi, forces classic mode
+				'wdio:enforceWebDriverClassic': true
 			}],
 			//
 			// ===================
@@ -155,13 +139,19 @@ module.exports.configure = (options) => {
 			//
 			// Default timeout in milliseconds for request
 			// if Selenium Grid doesn't send response
-			connectionRetryTimeout: 90000,
+			connectionRetryTimeout: 120000,
 			//
 			// Default request retries count
 			connectionRetryCount: 3,
 			// Ignore deprecation warnings
 			deprecationWarnings: false,
 			//
+			// Default timeouts
+			//
+			timeouts: {
+				script: 60000 // extend script timeout to 60s just in case
+			},
+			//
 			// Initialize the browser instance with a WebdriverIO plugin. The object should have the
 			// plugin name as key and the desired plugin options as properties. Make sure you have
 			// the plugin installed before running any tests. The following plugins are currently
@@ -185,9 +175,6 @@ module.exports.configure = (options) => {
 			// your test setup with almost no effort. Unlike plugins, they don't add new
 			// commands. Instead, they hook themselves up into the test process.
 			services: [
-				['selenium-standalone', {
-					skipSeleniumInstall: offline
-				}],
 				['static-server', {
 					folders: [
 						{mount: '/', path: './tests/' + base + '/dist'}
@@ -219,13 +206,15 @@ module.exports.configure = (options) => {
 			 * Gets executed before test execution begins. At this point you can access to all global
 			 * variables like `browser`. It is the perfect place to define custom commands.
 			 */
-			before: function () {
-				require('expect-webdriverio');
-
+			before: async function () {
 				global.wdioExpect = global.expect;
+				// in Chrome 132, the browser window size takes into account also the address bar and tab area
+				await browser.maximizeWindow();
+				let browserHeight = base === 'screenshot' ? 1080 : 1272;
+				await browser.setWindowSize(1920, browserHeight);
 
 				if (options.before) {
-					options.before();
+					await options.before();
 				}
 			}
 		}

package/eslint.config.js

@@ -1,5 +1,5 @@
-const enactStrict = require('eslint-config-enact/strict');
-const globals = require('globals');
+import enactStrict from 'eslint-config-enact/strict.js';
+import globals from 'globals';
 
 const customGlobals = {
 	'browser': true,
@@ -8,7 +8,7 @@ const customGlobals = {
 	'$$': true
 };
 
-module.exports = [
+export default [
 	...enactStrict,
 	{
 		languageOptions: {