@react-native-windows/automation 0.3.198 → 0.3.199

package/lib-commonjs/AutomationClient.d.ts

@@ -1,70 +1,70 @@
-/**
- * Copyright (c) Microsoft Corporation.
- * Licensed under the MIT License.
- *
- * @format
- */
-/// <reference types="webdriverio/webdriverio-core" />
-/**
- * Projection of a WebDriver Element, with functions corresponding to supported
- * WinAppDriver APIs.
- *
- * See https://github.com/microsoft/WinAppDriver/blob/master/Docs/SupportedAPIs.md
- */
-export type AutomationElement = Pick<WebdriverIO.Element, 'addValue' | 'clearValue' | 'click' | 'doubleClick' | 'findElements' | 'getAttribute' | 'getLocation' | 'getSize' | 'getText' | 'getValue' | 'isDisplayed' | 'isDisplayedInViewport' | 'isEnabled' | 'isEqual' | 'isSelected' | 'moveTo' | 'saveScreenshot' | 'sendKeys' | 'selectByVisibleText' | 'setValue' | 'touchAction' | 'waitForDisplayed' | 'waitForExist'>;
-/**
- * A subset of WebDriver functionality that will work with Windows applications
- */
-export declare const app: {
-    /**
-     * Find an element by testID property
-     */
-    findElementByTestID: (id: string) => Promise<AutomationElement>;
-    /**
-     * Find an element by Automation ID
-     *
-     * https://docs.microsoft.com/en-us/dotnet/api/system.windows.automation.automationelement.automationelementinformation.automationid?view=net-6.0
-     */
-    findElementByAutomationID: (id: string) => Promise<AutomationElement>;
-    /**
-     * Finds an element by the name of its class name (e.g. ListViewItem)
-     *
-     * https://docs.microsoft.com/en-us/dotnet/api/system.windows.automation.automationelement.automationelementinformation.classname?view=net-6.0
-     */
-    findElementByClassName: (className: string) => Promise<AutomationElement>;
-    /**
-     * Find element by ControlType (e.g. Button, CheckBox)
-     *
-     * https://docs.microsoft.com/en-us/dotnet/api/system.windows.automation.controltype?view=net-6.0
-     */
-    findElementByControlType: (controlType: string) => Promise<AutomationElement>;
-    /**
-     * Find element by a WinAppDriver compatible XPath Selector (e.g. '//Button[@AutomationId=\"MoreButton\"]')
-     */
-    findElementByXPath: (xpath: string) => Promise<AutomationElement>;
-    /**
-     * Resizes app window outer size according to provided width and height.
-     */
-    setWindowSize: (width: number, height: number) => Promise<object | null>;
-    /**
-     * Change the position of the current focussed window.
-     */
-    setWindowPosition: (x: number, y: number) => Promise<WebDriver.ProtocolCommandResponse>;
-    /**
-     * Get the position of the current focussed window.
-     */
-    getWindowPosition: () => Promise<WebDriver.ProtocolCommandResponse>;
-    /**
-     * Returns app window size.
-     */
-    getWindowSize: () => Promise<WebDriver.RectReturn>;
-    /**
-     * Switch focus to a particular window.
-     */
-    switchWindow: (titleToMatch: string | RegExp) => Promise<void>;
-    /**
-     * This wait command is your universal weapon if you want to wait on something. It expects a condition
-     * and waits until that condition is fulfilled with a truthy value.
-     */
-    waitUntil: (condition: () => Promise<boolean>, options?: WebdriverIO.WaitUntilOptions) => Promise<boolean>;
-};
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ *
+ * @format
+ */
+/// <reference types="webdriverio/webdriverio-core" />
+/**
+ * Projection of a WebDriver Element, with functions corresponding to supported
+ * WinAppDriver APIs.
+ *
+ * See https://github.com/microsoft/WinAppDriver/blob/master/Docs/SupportedAPIs.md
+ */
+export type AutomationElement = Pick<WebdriverIO.Element, 'addValue' | 'clearValue' | 'click' | 'doubleClick' | 'findElements' | 'getAttribute' | 'getLocation' | 'getSize' | 'getText' | 'getValue' | 'isDisplayed' | 'isDisplayedInViewport' | 'isEnabled' | 'isEqual' | 'isSelected' | 'moveTo' | 'saveScreenshot' | 'sendKeys' | 'selectByVisibleText' | 'setValue' | 'touchAction' | 'waitForDisplayed' | 'waitForExist'>;
+/**
+ * A subset of WebDriver functionality that will work with Windows applications
+ */
+export declare const app: {
+    /**
+     * Find an element by testID property
+     */
+    findElementByTestID: (id: string) => Promise<AutomationElement>;
+    /**
+     * Find an element by Automation ID
+     *
+     * https://docs.microsoft.com/en-us/dotnet/api/system.windows.automation.automationelement.automationelementinformation.automationid?view=net-6.0
+     */
+    findElementByAutomationID: (id: string) => Promise<AutomationElement>;
+    /**
+     * Finds an element by the name of its class name (e.g. ListViewItem)
+     *
+     * https://docs.microsoft.com/en-us/dotnet/api/system.windows.automation.automationelement.automationelementinformation.classname?view=net-6.0
+     */
+    findElementByClassName: (className: string) => Promise<AutomationElement>;
+    /**
+     * Find element by ControlType (e.g. Button, CheckBox)
+     *
+     * https://docs.microsoft.com/en-us/dotnet/api/system.windows.automation.controltype?view=net-6.0
+     */
+    findElementByControlType: (controlType: string) => Promise<AutomationElement>;
+    /**
+     * Find element by a WinAppDriver compatible XPath Selector (e.g. '//Button[@AutomationId=\"MoreButton\"]')
+     */
+    findElementByXPath: (xpath: string) => Promise<AutomationElement>;
+    /**
+     * Resizes app window outer size according to provided width and height.
+     */
+    setWindowSize: (width: number, height: number) => Promise<object | null>;
+    /**
+     * Change the position of the current focussed window.
+     */
+    setWindowPosition: (x: number, y: number) => Promise<WebDriver.ProtocolCommandResponse>;
+    /**
+     * Get the position of the current focussed window.
+     */
+    getWindowPosition: () => Promise<WebDriver.ProtocolCommandResponse>;
+    /**
+     * Returns app window size.
+     */
+    getWindowSize: () => Promise<WebDriver.RectReturn>;
+    /**
+     * Switch focus to a particular window.
+     */
+    switchWindow: (titleToMatch: string | RegExp) => Promise<void>;
+    /**
+     * This wait command is your universal weapon if you want to wait on something. It expects a condition
+     * and waits until that condition is fulfilled with a truthy value.
+     */
+    waitUntil: (condition: () => Promise<boolean>, options?: WebdriverIO.WaitUntilOptions) => Promise<boolean>;
+};

package/lib-commonjs/AutomationClient.js

@@ -1,66 +1,66 @@
-"use strict";
-/**
- * Copyright (c) Microsoft Corporation.
- * Licensed under the MIT License.
- *
- * @format
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.app = void 0;
-/**
- * A subset of WebDriver functionality that will work with Windows applications
- */
-exports.app = {
-    /**
-     * Find an element by testID property
-     */
-    findElementByTestID: (id) => $(`~${id}`),
-    /**
-     * Find an element by Automation ID
-     *
-     * https://docs.microsoft.com/en-us/dotnet/api/system.windows.automation.automationelement.automationelementinformation.automationid?view=net-6.0
-     */
-    findElementByAutomationID: (id) => $(`~${id}`),
-    /**
-     * Finds an element by the name of its class name (e.g. ListViewItem)
-     *
-     * https://docs.microsoft.com/en-us/dotnet/api/system.windows.automation.automationelement.automationelementinformation.classname?view=net-6.0
-     */
-    findElementByClassName: (className) => $(className),
-    /**
-     * Find element by ControlType (e.g. Button, CheckBox)
-     *
-     * https://docs.microsoft.com/en-us/dotnet/api/system.windows.automation.controltype?view=net-6.0
-     */
-    findElementByControlType: (controlType) => $(`<${controlType} />`),
-    /**
-     * Find element by a WinAppDriver compatible XPath Selector (e.g. '//Button[@AutomationId=\"MoreButton\"]')
-     */
-    findElementByXPath: (xpath) => $(xpath),
-    /**
-     * Resizes app window outer size according to provided width and height.
-     */
-    setWindowSize: (width, height) => browser.setWindowSize(width, height),
-    /**
-     * Change the position of the current focussed window.
-     */
-    setWindowPosition: (x, y) => browser.setWindowPosition(x, y),
-    /**
-     * Get the position of the current focussed window.
-     */
-    getWindowPosition: () => browser.getWindowPosition(),
-    /**
-     * Returns app window size.
-     */
-    getWindowSize: () => browser.getWindowSize(),
-    /**
-     * Switch focus to a particular window.
-     */
-    switchWindow: (titleToMatch) => browser.switchWindow(titleToMatch),
-    /**
-     * This wait command is your universal weapon if you want to wait on something. It expects a condition
-     * and waits until that condition is fulfilled with a truthy value.
-     */
-    waitUntil: (condition, options) => browser.waitUntil(condition, options),
-};
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ *
+ * @format
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.app = void 0;
+/**
+ * A subset of WebDriver functionality that will work with Windows applications
+ */
+exports.app = {
+    /**
+     * Find an element by testID property
+     */
+    findElementByTestID: (id) => $(`~${id}`),
+    /**
+     * Find an element by Automation ID
+     *
+     * https://docs.microsoft.com/en-us/dotnet/api/system.windows.automation.automationelement.automationelementinformation.automationid?view=net-6.0
+     */
+    findElementByAutomationID: (id) => $(`~${id}`),
+    /**
+     * Finds an element by the name of its class name (e.g. ListViewItem)
+     *
+     * https://docs.microsoft.com/en-us/dotnet/api/system.windows.automation.automationelement.automationelementinformation.classname?view=net-6.0
+     */
+    findElementByClassName: (className) => $(className),
+    /**
+     * Find element by ControlType (e.g. Button, CheckBox)
+     *
+     * https://docs.microsoft.com/en-us/dotnet/api/system.windows.automation.controltype?view=net-6.0
+     */
+    findElementByControlType: (controlType) => $(`<${controlType} />`),
+    /**
+     * Find element by a WinAppDriver compatible XPath Selector (e.g. '//Button[@AutomationId=\"MoreButton\"]')
+     */
+    findElementByXPath: (xpath) => $(xpath),
+    /**
+     * Resizes app window outer size according to provided width and height.
+     */
+    setWindowSize: (width, height) => browser.setWindowSize(width, height),
+    /**
+     * Change the position of the current focussed window.
+     */
+    setWindowPosition: (x, y) => browser.setWindowPosition(x, y),
+    /**
+     * Get the position of the current focussed window.
+     */
+    getWindowPosition: () => browser.getWindowPosition(),
+    /**
+     * Returns app window size.
+     */
+    getWindowSize: () => browser.getWindowSize(),
+    /**
+     * Switch focus to a particular window.
+     */
+    switchWindow: (titleToMatch) => browser.switchWindow(titleToMatch),
+    /**
+     * This wait command is your universal weapon if you want to wait on something. It expects a condition
+     * and waits until that condition is fulfilled with a truthy value.
+     */
+    waitUntil: (condition, options) => browser.waitUntil(condition, options),
+};
 //# sourceMappingURL=AutomationClient.js.map

package/lib-commonjs/AutomationEnvironment.d.ts

@@ -1,40 +1,40 @@
-/**
- * Copyright (c) Microsoft Corporation.
- * Licensed under the MIT License.
- *
- * @format
- */
-/// <reference types="webdriverio/webdriverio-core" />
-import NodeEnvironment from 'jest-environment-node';
-import { RemoteOptions } from 'webdriverio';
-import { JestEnvironmentConfig } from '@jest/environment';
-import type { EnvironmentContext } from '@jest/environment';
-export type EnvironmentOptions = {
-    /**
-     * The application to launch. Can be a path to an exe, or a package identity
-     * name (e.g. Microsoft.WindowsAlarms)
-     */
-    app?: string;
-    /**
-     * Arguments to be passed to your application when launched
-     */
-    appArguments?: string;
-    appWorkingDir?: string;
-    enableAutomationChannel?: boolean;
-    automationChannelPort?: number;
-    winAppDriverBin?: string;
-    breakOnStart?: boolean;
-    webdriverOptions?: RemoteOptions;
-};
-export default class AutomationEnvironment extends NodeEnvironment {
-    private readonly webDriverOptions;
-    private readonly channelOptions;
-    private readonly winappdriverBin;
-    private readonly breakOnStart;
-    private winAppDriverProcess;
-    private browser;
-    private automationClient;
-    constructor(config: JestEnvironmentConfig, context: EnvironmentContext);
-    setup(): Promise<void>;
-    teardown(): Promise<void>;
-}
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ *
+ * @format
+ */
+/// <reference types="webdriverio/webdriverio-core" />
+import NodeEnvironment from 'jest-environment-node';
+import { RemoteOptions } from 'webdriverio';
+import { JestEnvironmentConfig } from '@jest/environment';
+import type { EnvironmentContext } from '@jest/environment';
+export type EnvironmentOptions = {
+    /**
+     * The application to launch. Can be a path to an exe, or a package identity
+     * name (e.g. Microsoft.WindowsAlarms)
+     */
+    app?: string;
+    /**
+     * Arguments to be passed to your application when launched
+     */
+    appArguments?: string;
+    appWorkingDir?: string;
+    enableAutomationChannel?: boolean;
+    automationChannelPort?: number;
+    winAppDriverBin?: string;
+    breakOnStart?: boolean;
+    webdriverOptions?: RemoteOptions;
+};
+export default class AutomationEnvironment extends NodeEnvironment {
+    private readonly webDriverOptions;
+    private readonly channelOptions;
+    private readonly winappdriverBin;
+    private readonly breakOnStart;
+    private winAppDriverProcess;
+    private browser;
+    private automationClient;
+    constructor(config: JestEnvironmentConfig, context: EnvironmentContext);
+    setup(): Promise<void>;
+    teardown(): Promise<void>;
+}

package/lib-commonjs/AutomationEnvironment.js

@@ -1,170 +1,170 @@
-"use strict";
-/**
- * Copyright (c) Microsoft Corporation.
- * Licensed under the MIT License.
- *
- * @format
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const chalk_1 = __importDefault(require("chalk"));
-const child_process_1 = require("child_process");
-const fs_1 = __importDefault(require("@react-native-windows/fs"));
-const path_1 = __importDefault(require("path"));
-const readline_sync_1 = __importDefault(require("readline-sync"));
-const jest_environment_node_1 = __importDefault(require("jest-environment-node"));
-const webdriverio = __importStar(require("webdriverio"));
-const automation_channel_1 = require("@react-native-windows/automation-channel");
-class AutomationEnvironment extends jest_environment_node_1.default {
-    constructor(config, context) {
-        var _a;
-        super(config, context);
-        const passedOptions = config.projectConfig.testEnvironmentOptions;
-        if (!passedOptions.app) {
-            throw new Error('"app" must be specified in testEnvironmentOptions');
-        }
-        this.winappdriverBin =
-            passedOptions.winAppDriverBin ||
-                path_1.default.join(process.env['PROGRAMFILES(X86)'], 'Windows Application Driver\\WinAppDriver.exe');
-        if (!fs_1.default.existsSync(this.winappdriverBin)) {
-            throw new Error(`Could not find WinAppDriver at searched location: "${this.winappdriverBin}"`);
-        }
-        const baseOptions = {
-            hostname: '127.0.0.1',
-            port: 4723,
-            capabilities: {
-                app: resolveAppName(passedOptions.app),
-                ...(passedOptions.appWorkingDir && {
-                    appWorkingDir: passedOptions.appWorkingDir,
-                }),
-                ...(passedOptions.appArguments && {
-                    appArguments: passedOptions.appArguments,
-                }),
-                // @ts-ignore
-                'ms:experimental-webdriver': true,
-            },
-            // Level of logging verbosity: trace | debug | info | warn | error
-            logLevel: 'error',
-            // Default timeout for all waitFor* commands.
-            waitforTimeout: 30000,
-            // Default timeout in milliseconds for request
-            connectionRetryTimeout: 30000,
-            // Default request retries count
-            connectionRetryCount: 5,
-        };
-        this.webDriverOptions = Object.assign({}, baseOptions, passedOptions.webdriverOptions);
-        this.webDriverOptions.capabilities = Object.assign(this.webDriverOptions.capabilities, (_a = passedOptions.webdriverOptions) === null || _a === void 0 ? void 0 : _a.capabilities);
-        this.channelOptions = {
-            enable: passedOptions.enableAutomationChannel === true,
-            port: passedOptions.automationChannelPort || 8603,
-        };
-        this.breakOnStart = passedOptions.breakOnStart === true;
-    }
-    async setup() {
-        await super.setup();
-        this.winAppDriverProcess = await spawnWinAppDriver(this.winappdriverBin, this.webDriverOptions.port);
-        this.browser = await webdriverio.remote(this.webDriverOptions);
-        if (this.breakOnStart) {
-            readline_sync_1.default.question(chalk_1.default.bold.yellow('Breaking before tests start\n') +
-                'Press Enter to resume...');
-        }
-        if (this.channelOptions.enable) {
-            this.automationClient = await (0, automation_channel_1.waitForConnection)({
-                port: this.channelOptions.port,
-            });
-            this.global.automationClient = this.automationClient;
-        }
-        this.global.remote = webdriverio.remote;
-        this.global.browser = this.browser;
-        this.global.$ = this.browser.$.bind(this.browser);
-        this.global.$$ = this.browser.$$.bind(this.browser);
-    }
-    async teardown() {
-        var _a;
-        if (this.browser) {
-            await this.browser.deleteSession();
-        }
-        if (this.automationClient) {
-            this.automationClient.close();
-        }
-        (_a = this.winAppDriverProcess) === null || _a === void 0 ? void 0 : _a.kill('SIGINT');
-        await super.teardown();
-    }
-}
-exports.default = AutomationEnvironment;
-/**
- * Starts a WinAppdriver process and resolves a promise with the process once
- * it is ready to accept commands
- *
- * Inspired-by/stolen from https://github.com/licanhua/wdio-winappdriver-service
- */
-async function spawnWinAppDriver(winappdriverBin, port) {
-    if (!fs_1.default.existsSync(winappdriverBin)) {
-        throw new Error(`Could not locate WinAppDriver binary at "${winappdriverBin}"`);
-    }
-    return new Promise((resolve, reject) => {
-        const process = (0, child_process_1.spawn)(winappdriverBin, [port.toString()], { stdio: 'pipe' });
-        process.stdout.on('data', data => {
-            const s = data.toString('utf16le');
-            if (s.includes('Press ENTER to exit.')) {
-                resolve(process);
-            }
-            else if (s.includes('Failed to initialize')) {
-                reject(new Error('Failed to start WinAppDriver: ' + s));
-            }
-        });
-        process.stderr.once('data', err => {
-            console.warn(err);
-        });
-        process.once('exit', exitCode => {
-            reject(new Error(`WinAppDriver CLI exited before timeout (exit code: ${exitCode})`));
-        });
-    });
-}
-/**
- * Convert a package identity or path to exe to the form expected by a WinAppDriver capability
- */
-function resolveAppName(appName) {
-    if (appName.endsWith('.exe')) {
-        return appName;
-    }
-    try {
-        const packageFamilyName = (0, child_process_1.execSync)(`powershell (Get-AppxPackage -Name ${appName}).PackageFamilyName`)
-            .toString()
-            .trim();
-        if (packageFamilyName.length === 0) {
-            // Rethrown below
-            throw new Error();
-        }
-        return `${packageFamilyName}!App`;
-    }
-    catch (_a) {
-        throw new Error(`Could not locate a package with identity "${appName}"`);
-    }
-}
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ *
+ * @format
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chalk_1 = __importDefault(require("chalk"));
+const child_process_1 = require("child_process");
+const fs_1 = __importDefault(require("@react-native-windows/fs"));
+const path_1 = __importDefault(require("path"));
+const readline_sync_1 = __importDefault(require("readline-sync"));
+const jest_environment_node_1 = __importDefault(require("jest-environment-node"));
+const webdriverio = __importStar(require("webdriverio"));
+const automation_channel_1 = require("@react-native-windows/automation-channel");
+class AutomationEnvironment extends jest_environment_node_1.default {
+    constructor(config, context) {
+        var _a;
+        super(config, context);
+        const passedOptions = config.projectConfig.testEnvironmentOptions;
+        if (!passedOptions.app) {
+            throw new Error('"app" must be specified in testEnvironmentOptions');
+        }
+        this.winappdriverBin =
+            passedOptions.winAppDriverBin ||
+                path_1.default.join(process.env['PROGRAMFILES(X86)'], 'Windows Application Driver\\WinAppDriver.exe');
+        if (!fs_1.default.existsSync(this.winappdriverBin)) {
+            throw new Error(`Could not find WinAppDriver at searched location: "${this.winappdriverBin}"`);
+        }
+        const baseOptions = {
+            hostname: '127.0.0.1',
+            port: 4723,
+            capabilities: {
+                app: resolveAppName(passedOptions.app),
+                ...(passedOptions.appWorkingDir && {
+                    appWorkingDir: passedOptions.appWorkingDir,
+                }),
+                ...(passedOptions.appArguments && {
+                    appArguments: passedOptions.appArguments,
+                }),
+                // @ts-ignore
+                'ms:experimental-webdriver': true,
+            },
+            // Level of logging verbosity: trace | debug | info | warn | error
+            logLevel: 'error',
+            // Default timeout for all waitFor* commands.
+            waitforTimeout: 30000,
+            // Default timeout in milliseconds for request
+            connectionRetryTimeout: 30000,
+            // Default request retries count
+            connectionRetryCount: 5,
+        };
+        this.webDriverOptions = Object.assign({}, baseOptions, passedOptions.webdriverOptions);
+        this.webDriverOptions.capabilities = Object.assign(this.webDriverOptions.capabilities, (_a = passedOptions.webdriverOptions) === null || _a === void 0 ? void 0 : _a.capabilities);
+        this.channelOptions = {
+            enable: passedOptions.enableAutomationChannel === true,
+            port: passedOptions.automationChannelPort || 8603,
+        };
+        this.breakOnStart = passedOptions.breakOnStart === true;
+    }
+    async setup() {
+        await super.setup();
+        this.winAppDriverProcess = await spawnWinAppDriver(this.winappdriverBin, this.webDriverOptions.port);
+        this.browser = await webdriverio.remote(this.webDriverOptions);
+        if (this.breakOnStart) {
+            readline_sync_1.default.question(chalk_1.default.bold.yellow('Breaking before tests start\n') +
+                'Press Enter to resume...');
+        }
+        if (this.channelOptions.enable) {
+            this.automationClient = await (0, automation_channel_1.waitForConnection)({
+                port: this.channelOptions.port,
+            });
+            this.global.automationClient = this.automationClient;
+        }
+        this.global.remote = webdriverio.remote;
+        this.global.browser = this.browser;
+        this.global.$ = this.browser.$.bind(this.browser);
+        this.global.$$ = this.browser.$$.bind(this.browser);
+    }
+    async teardown() {
+        var _a;
+        if (this.browser) {
+            await this.browser.deleteSession();
+        }
+        if (this.automationClient) {
+            this.automationClient.close();
+        }
+        (_a = this.winAppDriverProcess) === null || _a === void 0 ? void 0 : _a.kill('SIGINT');
+        await super.teardown();
+    }
+}
+exports.default = AutomationEnvironment;
+/**
+ * Starts a WinAppdriver process and resolves a promise with the process once
+ * it is ready to accept commands
+ *
+ * Inspired-by/stolen from https://github.com/licanhua/wdio-winappdriver-service
+ */
+async function spawnWinAppDriver(winappdriverBin, port) {
+    if (!fs_1.default.existsSync(winappdriverBin)) {
+        throw new Error(`Could not locate WinAppDriver binary at "${winappdriverBin}"`);
+    }
+    return new Promise((resolve, reject) => {
+        const process = (0, child_process_1.spawn)(winappdriverBin, [port.toString()], { stdio: 'pipe' });
+        process.stdout.on('data', data => {
+            const s = data.toString('utf16le');
+            if (s.includes('Press ENTER to exit.')) {
+                resolve(process);
+            }
+            else if (s.includes('Failed to initialize')) {
+                reject(new Error('Failed to start WinAppDriver: ' + s));
+            }
+        });
+        process.stderr.once('data', err => {
+            console.warn(err);
+        });
+        process.once('exit', exitCode => {
+            reject(new Error(`WinAppDriver CLI exited before timeout (exit code: ${exitCode})`));
+        });
+    });
+}
+/**
+ * Convert a package identity or path to exe to the form expected by a WinAppDriver capability
+ */
+function resolveAppName(appName) {
+    if (appName.endsWith('.exe')) {
+        return appName;
+    }
+    try {
+        const packageFamilyName = (0, child_process_1.execSync)(`powershell (Get-AppxPackage -Name ${appName}).PackageFamilyName`)
+            .toString()
+            .trim();
+        if (packageFamilyName.length === 0) {
+            // Rethrown below
+            throw new Error();
+        }
+        return `${packageFamilyName}!App`;
+    }
+    catch (_a) {
+        throw new Error(`Could not locate a package with identity "${appName}"`);
+    }
+}
 //# sourceMappingURL=AutomationEnvironment.js.map

package/lib-commonjs/index.d.ts

@@ -1,11 +1,11 @@
-/**
- * Copyright (c) Microsoft Corporation.
- * Licensed under the MIT License.
- *
- * @format
- */
-import AutomationEnvironment from './AutomationEnvironment';
-import { app, AutomationElement } from './AutomationClient';
-export { app };
-export type { AutomationElement };
-export default AutomationEnvironment;
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ *
+ * @format
+ */
+import AutomationEnvironment from './AutomationEnvironment';
+import { app, AutomationElement } from './AutomationClient';
+export { app };
+export type { AutomationElement };
+export default AutomationEnvironment;

package/lib-commonjs/index.js

@@ -1,17 +1,17 @@
-"use strict";
-/**
- * Copyright (c) Microsoft Corporation.
- * Licensed under the MIT License.
- *
- * @format
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.app = void 0;
-const AutomationEnvironment_1 = __importDefault(require("./AutomationEnvironment"));
-const AutomationClient_1 = require("./AutomationClient");
-Object.defineProperty(exports, "app", { enumerable: true, get: function () { return AutomationClient_1.app; } });
-exports.default = AutomationEnvironment_1.default;
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ *
+ * @format
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.app = void 0;
+const AutomationEnvironment_1 = __importDefault(require("./AutomationEnvironment"));
+const AutomationClient_1 = require("./AutomationClient");
+Object.defineProperty(exports, "app", { enumerable: true, get: function () { return AutomationClient_1.app; } });
+exports.default = AutomationEnvironment_1.default;
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native-windows/automation",
-  "version": "0.3.198",
+  "version": "0.3.199",
   "description": "UI Automation Suite for React Native Windows Applications",
   "main": "lib-commonjs/index.js",
   "repository": {
@@ -18,8 +18,8 @@
     "watch": "rnw-scripts watch"
   },
   "dependencies": {
-    "@react-native-windows/automation-channel": "^0.12.116",
-    "@react-native-windows/fs": "^0.0.0-canary.34",
+    "@react-native-windows/automation-channel": "^0.12.117",
+    "@react-native-windows/fs": "^0.0.0-canary.35",
     "@typescript-eslint/eslint-plugin": "^5.30.5",
     "@typescript-eslint/parser": "^5.57.1",
     "chalk": "^4.1.2",
@@ -30,15 +30,15 @@
     "@jest/create-cache-key-function": "^29.2.1",
     "@jest/environment": "^29.3.0",
     "@jest/types": "^29.2.1",
-    "@rnw-scripts/eslint-config": "1.2.5",
-    "@rnw-scripts/just-task": "2.3.21",
+    "@rnw-scripts/eslint-config": "1.2.6",
+    "@rnw-scripts/just-task": "2.3.22",
     "@rnw-scripts/ts-config": "2.0.5",
     "@types/jest": "^29.2.2",
     "@types/node": "^18.0.0",
     "@types/readline-sync": "^1.4.4",
     "eslint": "^8.19.0",
-    "prettier": "^2.4.1",
-    "typescript": "^4.9.5"
+    "prettier": "2.8.8",
+    "typescript": "5.0.4"
   },
   "peerDependencies": {
     "jest": ">=29.0.3",