@oracle/oraclejet-selenium-driver 19.0.0

package/DriverManager/DriverManager.mjs

@@ -0,0 +1,330 @@
+import { Capabilities, Builder } from 'selenium-webdriver';
+
+/**
+ * @private
+ */
+const defaultConfigName = '';
+/**
+ * @private
+ */
+const defaultCapabilities = new Capabilities({
+    autoWebview: true,
+    browserName: 'chrome'
+});
+/**
+ * @private
+ */
+const defaultTimeouts = {
+    implicit: 0,
+    pageLoad: 30000,
+    script: 30000
+};
+/**
+ * @private
+ */
+const configs = {};
+/**
+ * @private
+ */
+let currentInstance = {
+    configName: undefined,
+    driver: undefined
+};
+/**
+ * The delay, in milliseconds, that the manager will wait after the driver is
+ * release to see if there are pending requests for a driver instance.  If no
+ * requests exist, then the driver is closed, and subsequent requests will
+ * receive a new instance.
+ * @private
+ */
+const quitDelay = 500;
+/**
+ * @private
+ */
+let builder;
+/**
+ * The NodeJS.Timer used to cleanup the driver instance if no subsequent test
+ * asks for the driver. The type (NodeJS.Timer) cannot be defined here because
+ * typedoc cannot resolve the NodeJS namespace, so we infer it by calling
+ * setTimeout instead.
+ * @private
+ */
+let releaseTimer = setTimeout(() => true, 0);
+/**
+ * Manage instances of [WebDriver](index._internal_.WebDriver.html)
+ * to be used by the tests. DriverManager
+ * allows a single place where the WebDriver instance can be configured and
+ * reused. Traditionally, tests instantiate the WebDriver instance on their own,
+ * passing configurations such as the browser to use:
+ * ```javascript
+ * let driver = new Builder().withCapabilities({
+ *   browserName: "chrome"
+ * }).build()
+ * ```
+ * This boilerplate code then has to be copied to every test. Additionally, if
+ * the capabilities need to change (say, running against a different browser),
+ * that change must be applied to all test files.
+ *
+ * DriverManager addresses this problem by centralizing the place whereby
+ * the configuration is done, and persists that configuration for all
+ * subsequent requests for the WebDriver instance. The configuration only needs
+ * to be set once in a "setup" file, and tests retrieve the configured instance
+ * without needing to define anything else.
+ *
+ * A sample <code>mocha-setup.ts</code> file which configures DriverManager
+ * ```javascript
+ * import { DriverManager } from "@oracle/oraclejet-selenium-driver/DriverManager";
+ *
+ * DriverManager.registerConfig({
+ *   capabilities: new Capabilities({
+ *     browserName: "chrome"
+ *   })
+ * })
+ * ```
+ * This setup test script should be run before any other tests.
+ * ```bash
+ * $ node node_modules/mocha/bin/mocha --require=ts-node/register mocha-setup.ts other-test.spec.ts ...
+ * ```
+ * Test files are agnostic of the driver configuration, and simply get the instance
+ * by calling <code>getDriver()</code>
+ * ```javascript
+ * import { DriverManager } from "@oracle/oraclejet-selenium-driver/DriverManager";
+ *
+ * describe("My test suite", function() {
+ *   let driver: WebDriver;
+ *
+ *   before(async function() {
+ *     driver = await DriverManager.getDriver();
+ *   })
+ *   it("open a page to test", async function() {
+ *     await driver.get("...")
+ *   })
+ *   after(async function() {
+ *     await DriverManager.releaseDriver(driver);
+ *   })
+ * })
+ * ```
+ *
+ * ## Set default timeouts for WebDriver from Mocha.
+ * When Mocha is used to start the WebDriver tests, there are two sets of timeout
+ * values--one from Mocha and one from WebDriver. This causes some confusion as
+ * the command-line argument <code>--timeout=nnn</code> is typically the only one
+ * set and assumed to be the only timeout value in play. However, WebDriver has
+ * its own set of timeout values whose defaults are sometimes longer than what's
+ * set for Mocha. When this happens, WebDriver may be waiting on a condition to
+ * timeout, but Mocha has errored the test because its own timeout was exceeded.
+ * To ensure that WebDriver timeout conditions are properly reported to the test
+ * runner (Mocha), its timeout values must be set to a value shorter than the
+ * runner's. This is typically done in the setup test, and set to some factor of
+ * the Mocha timeout.
+ *
+ * ### Set WebDriver timeout to 1/4 of Mocha
+ * ```javascript
+ * const mochaTimeout = this.timeouts();
+ * const wdTimeout = mochaTimeout / 4;
+ * DriverManager.registerConfig({
+ *   timeouts: {
+ *     pageLoad: wdTimeout,
+ *     script: wdTimeout,
+ *     implicit: wdTimeout
+ *   }
+ * });
+ * ```
+ *
+ */
+class DriverManager {
+    /**
+     * Optionally set the {@link Builder}
+     * instance used by DriverManager to create WebDriver.
+     * The Builder allows different settings for thigns such as the remote server,
+     * proxies, and other runtime options often needed when running in distributed
+     * environments.
+     * The instance can be preconfigured with capabilities, and any additional
+     * capabilities from [[registerConfig]] will also be applied during the
+     * creation process.  If no Builder is explicitly passed, a default one will
+     * be used.
+     * If setting a custom Builder, this function must be called before the first
+     * test calls [[getDriver]], and must only be called once per test run. If called
+     * multiple times or after [[getDriver]], an error will be thrown.
+     * @param b A builder instance
+     */
+    static setBuilder(b) {
+        if (builder) {
+            throw Error('DriverManager Builder instance has already been set, and cannot be set again');
+        }
+        builder = b;
+    }
+    /**
+     * Register a configuration for WebDriver instances. Configurations consist of
+     * {@link Capabilities} and/or {@link Timeouts}.
+     * This configuration is used by [[getDriver]] to retrieve a configured WebDriver
+     * instance.
+     * @param config The driver configuration
+     * @param name An optional name to assocaite with the config. If no name is given,
+     * the config will be the default. If a name is given, its configuration is merged with the default
+     * with its values taking precedence.
+     *
+     * ### Register a default config
+     * ```javascript
+     * DriverManager.registerConfig(
+     *   {
+     *     capabilities: new Capabilities({
+     *       browserName: "chrome"
+     *     }),
+     *     timeouts: {
+     *       implicit: 5000
+     *     }
+     *   }
+     * );
+     * ```
+     * ### Register a Firefox config. These capabilities override any matching ones set in the default
+     * ```javascript
+     * DriverManager.registerConfig(
+     *   {
+     *     capabilities: new Capabilities({
+     *       browserName: "firefox",
+     *       hideAlerts: true
+     *     })
+     *   },
+     *   "firefox-no-alerts"
+     * );
+     * ```
+     */
+    static registerConfig(config, name) {
+        configs[name || defaultConfigName] = config;
+    }
+    /**
+     * Get a {@link WebDriver}
+     * instance for a given configuration. If no configName is given, the returned
+     * driver will use the default configuration.
+     * @see [[registerConfig]]
+     *
+     * ### Get driver with default capabilities
+     * ```javascript
+     * let driver = await DriverManager.getDriver();
+     * ```
+     * ### Configure and get Firefox driver
+     * ```javascript
+     * // mocha-setup.ts
+     * DriverManager.registerConfig(
+     *   {
+     *     browserName: "firefox"
+     *   },
+     *   "firefox-config");
+     * // test.spec.ts
+     * let driver = await DriverManager.getDriver("firefox-config");
+     * ```
+     * @param configName An optional configuration name, registered through
+     * [[registerConfig]], whose set will be applied to the driver instance. If no
+     * name is given, the default configuration with the "chrome" browser
+     * will be used. If the given configName doesn't exist, an error will be thrown.
+     * @return A Promise that resolves to a WebDriver instance, configured with
+     * custom capabilities for the given configName, or the default capabilities
+     * if none is specified.
+     */
+    static async getDriver(configName) {
+        clearTimeout(releaseTimer);
+        configName = configName || defaultConfigName;
+        if (configName === currentInstance.configName) {
+            // Test if current driver is still valid
+            try {
+                if (currentInstance.driver) {
+                    await currentInstance.driver.getCurrentUrl();
+                    return currentInstance.driver;
+                }
+            }
+            catch {
+                // no driver or already quit
+            }
+        }
+        await quitCurrentDriver();
+        return createDriver(configName);
+    }
+    /**
+     * Gets the current driver instance, if one exists, otherwise create and
+     * return the default one. This method is useful for test setups which evaluate
+     * the outcome of the previous test to capture screenshots on failures. After-
+     * scripts call <code>getCurrentDriver</code> to get the instance of the driver
+     * that experienced the test failure, then capture the screenshot from it.
+     */
+    static async getCurrentDriver() {
+        return DriverManager.getDriver(currentInstance.configName);
+    }
+    /**
+     * Release the WebDriver instance from use.  Called when each test is done
+     * with its driver usage, typically, in the <code>after/afterAll</code> function.
+     * If `immediate` is not given, this method will delay a brief time before telling
+     * the driver to quit, allowing subsequent tests to reuse the same instance.
+     * If a call to {@link getDriver} is called before the timeout is reached,
+     * then the release is aborted.
+     * If `immediate` is true, then a Promise<void> will be returned and the driver
+     * told to quit immediately.
+     * @param driver The WebDriver instance
+     * @param immediate Immediately release the driver without delay
+     * @returns Promise<void> A Promise that will resolve when the driver is released if
+     * `immediate` is true, otherwise, void
+     */
+    static releaseDriver(driver, immediate = false) {
+        clearTimeout(releaseTimer);
+        return new Promise((resolve) => {
+            if (immediate) {
+                resolve(quitDriver(driver));
+            }
+            else {
+                releaseTimer = setTimeout(() => quitDriver(driver), quitDelay);
+                resolve();
+            }
+        });
+    }
+}
+DriverManager.registerConfig({ capabilities: defaultCapabilities, timeouts: defaultTimeouts });
+/**
+ * Create a WebDriver instance from the given configuration name. The config should
+ * already be registered via [registerConfig].
+ * @param configName The configuration name used to retrieve the configuration
+ * object for the driver instance
+ * @return A Promise which resolves to the configured WebDriver instance
+ * @private
+ */
+async function createDriver(configName) {
+    const config = configs[configName];
+    if (!config) {
+        throw Error(`No driver configuration exists for "${configName}"`);
+    }
+    // Merge default capabilities with custom ones
+    const caps = new Capabilities(configs[defaultConfigName].capabilities);
+    if (config.capabilities) {
+        caps.merge(config.capabilities);
+    }
+    // Merge default timeouts with custom ones
+    const timeouts = Object.assign({}, configs[defaultConfigName].timeouts, config.timeouts);
+    if (!builder) {
+        builder = new Builder();
+    }
+    const driver = builder.withCapabilities(caps).build();
+    currentInstance = { configName, driver };
+    await driver.manage().setTimeouts(timeouts);
+    return driver;
+}
+/**
+ * @private
+ */
+function quitCurrentDriver() {
+    return quitDriver(currentInstance.driver);
+}
+/**
+ * @private
+ */
+function quitDriver(driver) {
+    if (driver) {
+        currentInstance = {
+            configName: undefined,
+            driver: undefined
+        };
+        return driver.quit().catch(console.warn);
+    }
+    return Promise.resolve();
+}
+
+export { DriverManager };
+//# sourceMappingURL=DriverManager.mjs.map

package/DriverManager/DriverManager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DriverManager.mjs","sources":["../../src/DriverManager/DriverManager.ts"],"sourcesContent":["import { Builder, Capabilities, WebDriver } from 'selenium-webdriver';\n\ninterface Timeouts {\n  /**\n   * The timeout value for script execution.  Default 30000\n   */\n  script?: number;\n  /**\n   * The timeout value for page loading (and to be ready).  Default 30000\n   */\n  pageLoad?: number;\n  /**\n   * The timeout value for finding an element on the page.  Default 0\n   */\n  implicit?: number;\n}\nexport interface DriverConfiguration {\n  /**\n   * The WebDriver Capabilties for the configuration\n   */\n  capabilities?: Capabilities | Record<string, any>;\n  /**\n   * The WebDriver timeout values for the configuration\n   */\n  timeouts?: Timeouts;\n}\n\n/**\n * @private\n */\nconst defaultConfigName = '';\n/**\n * @private\n */\nconst defaultCapabilities = new Capabilities({\n  autoWebview: true,\n  browserName: 'chrome'\n});\n/**\n * @private\n */\nconst defaultTimeouts: Timeouts = {\n  implicit: 0,\n  pageLoad: 30000,\n  script: 30000\n};\n/**\n * @private\n */\nconst configs: Record<string, DriverConfiguration> = {};\n/**\n * @private\n */\nlet currentInstance: { configName: string | undefined; driver: WebDriver | undefined } = {\n  configName: undefined,\n  driver: undefined\n};\n\n/**\n * The delay, in milliseconds, that the manager will wait after the driver is\n * release to see if there are pending requests for a driver instance.  If no\n * requests exist, then the driver is closed, and subsequent requests will\n * receive a new instance.\n * @private\n */\nconst quitDelay = 500;\n/**\n * @private\n */\nlet builder: Builder;\n/**\n * The NodeJS.Timer used to cleanup the driver instance if no subsequent test\n * asks for the driver. The type (NodeJS.Timer) cannot be defined here because\n * typedoc cannot resolve the NodeJS namespace, so we infer it by calling\n * setTimeout instead.\n * @private\n */\nlet releaseTimer = setTimeout(() => true, 0);\n\n/**\n * Manage instances of [WebDriver](index._internal_.WebDriver.html)\n * to be used by the tests. DriverManager\n * allows a single place where the WebDriver instance can be configured and\n * reused. Traditionally, tests instantiate the WebDriver instance on their own,\n * passing configurations such as the browser to use:\n * ```javascript\n * let driver = new Builder().withCapabilities({\n *   browserName: \"chrome\"\n * }).build()\n * ```\n * This boilerplate code then has to be copied to every test. Additionally, if\n * the capabilities need to change (say, running against a different browser),\n * that change must be applied to all test files.\n *\n * DriverManager addresses this problem by centralizing the place whereby\n * the configuration is done, and persists that configuration for all\n * subsequent requests for the WebDriver instance. The configuration only needs\n * to be set once in a \"setup\" file, and tests retrieve the configured instance\n * without needing to define anything else.\n *\n * A sample <code>mocha-setup.ts</code> file which configures DriverManager\n * ```javascript\n * import { DriverManager } from \"@oracle/oraclejet-selenium-driver/DriverManager\";\n *\n * DriverManager.registerConfig({\n *   capabilities: new Capabilities({\n *     browserName: \"chrome\"\n *   })\n * })\n * ```\n * This setup test script should be run before any other tests.\n * ```bash\n * $ node node_modules/mocha/bin/mocha --require=ts-node/register mocha-setup.ts other-test.spec.ts ...\n * ```\n * Test files are agnostic of the driver configuration, and simply get the instance\n * by calling <code>getDriver()</code>\n * ```javascript\n * import { DriverManager } from \"@oracle/oraclejet-selenium-driver/DriverManager\";\n *\n * describe(\"My test suite\", function() {\n *   let driver: WebDriver;\n *\n *   before(async function() {\n *     driver = await DriverManager.getDriver();\n *   })\n *   it(\"open a page to test\", async function() {\n *     await driver.get(\"...\")\n *   })\n *   after(async function() {\n *     await DriverManager.releaseDriver(driver);\n *   })\n * })\n * ```\n *\n * ## Set default timeouts for WebDriver from Mocha.\n * When Mocha is used to start the WebDriver tests, there are two sets of timeout\n * values--one from Mocha and one from WebDriver. This causes some confusion as\n * the command-line argument <code>--timeout=nnn</code> is typically the only one\n * set and assumed to be the only timeout value in play. However, WebDriver has\n * its own set of timeout values whose defaults are sometimes longer than what's\n * set for Mocha. When this happens, WebDriver may be waiting on a condition to\n * timeout, but Mocha has errored the test because its own timeout was exceeded.\n * To ensure that WebDriver timeout conditions are properly reported to the test\n * runner (Mocha), its timeout values must be set to a value shorter than the\n * runner's. This is typically done in the setup test, and set to some factor of\n * the Mocha timeout.\n *\n * ### Set WebDriver timeout to 1/4 of Mocha\n * ```javascript\n * const mochaTimeout = this.timeouts();\n * const wdTimeout = mochaTimeout / 4;\n * DriverManager.registerConfig({\n *   timeouts: {\n *     pageLoad: wdTimeout,\n *     script: wdTimeout,\n *     implicit: wdTimeout\n *   }\n * });\n * ```\n *\n */\nexport class DriverManager {\n  /**\n   * Optionally set the {@link Builder}\n   * instance used by DriverManager to create WebDriver.\n   * The Builder allows different settings for thigns such as the remote server,\n   * proxies, and other runtime options often needed when running in distributed\n   * environments.\n   * The instance can be preconfigured with capabilities, and any additional\n   * capabilities from [[registerConfig]] will also be applied during the\n   * creation process.  If no Builder is explicitly passed, a default one will\n   * be used.\n   * If setting a custom Builder, this function must be called before the first\n   * test calls [[getDriver]], and must only be called once per test run. If called\n   * multiple times or after [[getDriver]], an error will be thrown.\n   * @param b A builder instance\n   */\n  public static setBuilder(b: Builder) {\n    if (builder) {\n      throw Error('DriverManager Builder instance has already been set, and cannot be set again');\n    }\n    builder = b;\n  }\n  /**\n   * Register a configuration for WebDriver instances. Configurations consist of\n   * {@link Capabilities} and/or {@link Timeouts}.\n   * This configuration is used by [[getDriver]] to retrieve a configured WebDriver\n   * instance.\n   * @param config The driver configuration\n   * @param name An optional name to assocaite with the config. If no name is given,\n   * the config will be the default. If a name is given, its configuration is merged with the default\n   * with its values taking precedence.\n   *\n   * ### Register a default config\n   * ```javascript\n   * DriverManager.registerConfig(\n   *   {\n   *     capabilities: new Capabilities({\n   *       browserName: \"chrome\"\n   *     }),\n   *     timeouts: {\n   *       implicit: 5000\n   *     }\n   *   }\n   * );\n   * ```\n   * ### Register a Firefox config. These capabilities override any matching ones set in the default\n   * ```javascript\n   * DriverManager.registerConfig(\n   *   {\n   *     capabilities: new Capabilities({\n   *       browserName: \"firefox\",\n   *       hideAlerts: true\n   *     })\n   *   },\n   *   \"firefox-no-alerts\"\n   * );\n   * ```\n   */\n  public static registerConfig(config: DriverConfiguration, name?: string): void {\n    configs[name || defaultConfigName] = config;\n  }\n\n  /**\n   * Get a {@link WebDriver}\n   * instance for a given configuration. If no configName is given, the returned\n   * driver will use the default configuration.\n   * @see [[registerConfig]]\n   *\n   * ### Get driver with default capabilities\n   * ```javascript\n   * let driver = await DriverManager.getDriver();\n   * ```\n   * ### Configure and get Firefox driver\n   * ```javascript\n   * // mocha-setup.ts\n   * DriverManager.registerConfig(\n   *   {\n   *     browserName: \"firefox\"\n   *   },\n   *   \"firefox-config\");\n   * // test.spec.ts\n   * let driver = await DriverManager.getDriver(\"firefox-config\");\n   * ```\n   * @param configName An optional configuration name, registered through\n   * [[registerConfig]], whose set will be applied to the driver instance. If no\n   * name is given, the default configuration with the \"chrome\" browser\n   * will be used. If the given configName doesn't exist, an error will be thrown.\n   * @return A Promise that resolves to a WebDriver instance, configured with\n   * custom capabilities for the given configName, or the default capabilities\n   * if none is specified.\n   */\n  public static async getDriver(configName?: string): Promise<WebDriver> {\n    clearTimeout(releaseTimer);\n    configName = configName || defaultConfigName;\n\n    if (configName === currentInstance.configName) {\n      // Test if current driver is still valid\n      try {\n        if (currentInstance.driver) {\n          await currentInstance.driver.getCurrentUrl();\n          return currentInstance.driver;\n        }\n      } catch {\n        // no driver or already quit\n      }\n    }\n\n    await quitCurrentDriver();\n    return createDriver(configName);\n  }\n\n  /**\n   * Gets the current driver instance, if one exists, otherwise create and\n   * return the default one. This method is useful for test setups which evaluate\n   * the outcome of the previous test to capture screenshots on failures. After-\n   * scripts call <code>getCurrentDriver</code> to get the instance of the driver\n   * that experienced the test failure, then capture the screenshot from it.\n   */\n  public static async getCurrentDriver(): Promise<WebDriver> {\n    return DriverManager.getDriver(currentInstance.configName);\n  }\n\n  /**\n   * Release the WebDriver instance from use.  Called when each test is done\n   * with its driver usage, typically, in the <code>after/afterAll</code> function.\n   * If `immediate` is not given, this method will delay a brief time before telling\n   * the driver to quit, allowing subsequent tests to reuse the same instance.\n   * If a call to {@link getDriver} is called before the timeout is reached,\n   * then the release is aborted.\n   * If `immediate` is true, then a Promise<void> will be returned and the driver\n   * told to quit immediately.\n   * @param driver The WebDriver instance\n   * @param immediate Immediately release the driver without delay\n   * @returns Promise<void> A Promise that will resolve when the driver is released if\n   * `immediate` is true, otherwise, void\n   */\n  public static releaseDriver(driver: WebDriver, immediate = false): Promise<void> {\n    clearTimeout(releaseTimer);\n    return new Promise((resolve) => {\n      if (immediate) {\n        resolve(quitDriver(driver));\n      } else {\n        releaseTimer = setTimeout(() => quitDriver(driver), quitDelay);\n        resolve();\n      }\n    });\n  }\n}\nDriverManager.registerConfig({ capabilities: defaultCapabilities, timeouts: defaultTimeouts });\n\n/**\n * Create a WebDriver instance from the given configuration name. The config should\n * already be registered via [registerConfig].\n * @param configName The configuration name used to retrieve the configuration\n * object for the driver instance\n * @return A Promise which resolves to the configured WebDriver instance\n * @private\n */\nasync function createDriver(configName: string) {\n  const config = configs[configName];\n  if (!config) {\n    throw Error(`No driver configuration exists for \"${configName}\"`);\n  }\n  // Merge default capabilities with custom ones\n  const caps = new Capabilities(configs[defaultConfigName].capabilities);\n  if (config.capabilities) {\n    caps.merge(config.capabilities);\n  }\n  // Merge default timeouts with custom ones\n  const timeouts = Object.assign({}, configs[defaultConfigName].timeouts, config.timeouts);\n  if (!builder) {\n    builder = new Builder();\n  }\n\n  const driver = builder.withCapabilities(caps).build();\n  currentInstance = { configName, driver };\n  await driver.manage().setTimeouts(timeouts);\n  return driver;\n}\n\n/**\n * @private\n */\nfunction quitCurrentDriver() {\n  return quitDriver(currentInstance.driver);\n}\n\n/**\n * @private\n */\nfunction quitDriver(driver?: WebDriver) {\n  if (driver) {\n    currentInstance = {\n      configName: undefined,\n      driver: undefined\n    };\n    return driver.quit().catch(console.warn);\n  }\n  return Promise.resolve();\n}\n"],"names":[],"mappings":"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"}

package/DriverManager/index.cjs

@@ -0,0 +1,10 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var DriverManager = require('./DriverManager.cjs');
+
+
+
+exports.DriverManager = DriverManager.DriverManager;
+//# sourceMappingURL=index.cjs.map

package/DriverManager/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}

package/DriverManager/index.d.ts

@@ -0,0 +1 @@
+export { type DriverConfiguration, DriverManager } from './DriverManager';

package/DriverManager/index.mjs

@@ -0,0 +1,2 @@
+export { DriverManager } from './DriverManager.mjs';
+//# sourceMappingURL=index.mjs.map

package/DriverManager/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/UNSAFE_SeleniumDriver/SeleniumDriver.cjs

@@ -0,0 +1,169 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var UNSAFE_Driver = require('@oracle/oraclejet-testing/UNSAFE_Driver');
+var seleniumWebdriver = require('selenium-webdriver');
+
+const modifierKeys = {
+    SHIFT: seleniumWebdriver.Key.SHIFT,
+    CONTROL: seleniumWebdriver.Key.CONTROL,
+    CONTROL_COMMAND: seleniumWebdriver.Key.CONTROL,
+    ALT: seleniumWebdriver.Key.ALT
+};
+const keyMap = {
+    ...modifierKeys,
+    BACKSPACE: seleniumWebdriver.Key.BACK_SPACE,
+    TAB: seleniumWebdriver.Key.TAB,
+    ENTER: seleniumWebdriver.Key.ENTER,
+    ESCAPE: seleniumWebdriver.Key.ESCAPE,
+    PAGE_UP: seleniumWebdriver.Key.PAGE_UP,
+    PAGE_DOWN: seleniumWebdriver.Key.PAGE_DOWN,
+    END: seleniumWebdriver.Key.END,
+    HOME: seleniumWebdriver.Key.HOME,
+    ARROW_LEFT: seleniumWebdriver.Key.ARROW_LEFT,
+    ARROW_UP: seleniumWebdriver.Key.ARROW_UP,
+    ARROW_RIGHT: seleniumWebdriver.Key.ARROW_RIGHT,
+    ARROW_DOWN: seleniumWebdriver.Key.ARROW_DOWN,
+    DELETE: seleniumWebdriver.Key.DELETE,
+    F1: seleniumWebdriver.Key.F1,
+    F2: seleniumWebdriver.Key.F2,
+    F3: seleniumWebdriver.Key.F3,
+    F4: seleniumWebdriver.Key.F4,
+    F5: seleniumWebdriver.Key.F5,
+    F6: seleniumWebdriver.Key.F6,
+    F7: seleniumWebdriver.Key.F7,
+    F8: seleniumWebdriver.Key.F8,
+    F9: seleniumWebdriver.Key.F9,
+    F10: seleniumWebdriver.Key.F10,
+    F11: seleniumWebdriver.Key.F11,
+    F12: seleniumWebdriver.Key.F12
+};
+let currentScriptTimeout;
+class SeleniumDriver extends UNSAFE_Driver.TestDriverBase {
+    constructor(driver) {
+        super();
+        this._platform = '';
+        this._waitForElement = async (locator, parent) => {
+            try {
+                const el = await this.waitFor(() => parent.findElement(seleniumWebdriver.By.css(locator.css)), {
+                    timeout: UNSAFE_Driver.getTimeouts().elementExistsTimeout
+                });
+                return Promise.resolve(wrapElement(el, this._waitForElement, this._waitForElements));
+            }
+            catch {
+                throw Error(`No element matching query "${JSON.stringify(locator)}"`);
+            }
+        };
+        this._waitForElements = async (locator, parent) => {
+            let matches;
+            try {
+                // loop to find at least 1 match
+                matches = await this.waitFor(async () => {
+                    const all = await parent.findElements(seleniumWebdriver.By.css(locator.css));
+                    if (all.length) {
+                        return all;
+                    }
+                    return;
+                }, {
+                    timeout: UNSAFE_Driver.getTimeouts().elementExistsTimeout
+                });
+            }
+            catch {
+                return [];
+            }
+            return Promise.resolve(Array.from(matches || []).map((m) => wrapElement(m, this._waitForElement, this._waitForElements)));
+        };
+        this._driver = driver;
+    }
+    async executeScript(script, ...args) {
+        await this._setDriverTimeouts();
+        return this._driver.executeScript(script, ...args);
+    }
+    async waitForElement(locator) {
+        return this._waitForElement(locator, this._driver);
+    }
+    async waitForElements(locator) {
+        return this._waitForElements(locator, this._driver);
+    }
+    /**
+     * Get a TestElement for the given WebElement
+     * @param from The WebElement
+     * @returns A TestElement
+     */
+    getTestElement(from) {
+        return wrapElement(from, this._waitForElement, this._waitForElements);
+    }
+    async sendKeys(element, ...text) {
+        await this._ensurePlatform();
+        return this.unwrapElement(element).sendKeys(...text.map(this._getPlatformKey.bind(this)));
+    }
+    async click(element, options = {}) {
+        await this._ensurePlatform();
+        const modifiers = options.modifiers || [];
+        const actions = this._driver.actions();
+        if (modifiers) {
+            modifiers.map(this._getPlatformKey.bind(this)).forEach((m) => actions.keyDown(m));
+            await actions.perform();
+        }
+        await this.unwrapElement(element).click();
+        return actions.clear();
+    }
+    unwrapElement(element) {
+        return element._el;
+    }
+    async _ensurePlatform() {
+        if (!this._platform) {
+            this._platform = (await this._driver.getCapabilities()).getPlatform() || 'unknown';
+        }
+    }
+    /**
+     * Get the platform-specific key value for the key, if available.
+     * @param key The key value
+     * @returns A platform-specific value for the key, or the original key if none exists
+     */
+    _getPlatformKey(key) {
+        if (typeof key === 'object') {
+            return UNSAFE_Driver.Keys.CONTROL_COMMAND === key
+                ? this._platform === 'mac'
+                    ? seleniumWebdriver.Key.COMMAND
+                    : seleniumWebdriver.Key.CONTROL
+                : keyMap[key.key];
+        }
+        return key;
+    }
+    _setDriverTimeouts() {
+        const { scriptTimeout } = UNSAFE_Driver.getTimeouts();
+        if (scriptTimeout !== currentScriptTimeout) {
+            currentScriptTimeout = scriptTimeout;
+            // set script timeout
+            // we don't set implicit (waitForElement) because we want to enforce our own behavior
+            return this._driver.manage().setTimeouts({
+                script: scriptTimeout
+            });
+        }
+        return;
+    }
+}
+function wrapElement(element, waitForElement, waitForElements) {
+    return new TestElementImpl(element, waitForElement, waitForElements);
+}
+class TestElementImpl {
+    constructor(element, waitForElement, waitForElements) {
+        this._el = element;
+        this._waitForElement = waitForElement;
+        this._waitForElements = waitForElements;
+    }
+    waitForElement(locator) {
+        return this._waitForElement(locator, this._el);
+    }
+    waitForElements(locator) {
+        return this._waitForElements(locator, this._el);
+    }
+    getAttribute(attrName) {
+        return this._el.getAttribute(attrName);
+    }
+}
+
+exports.SeleniumDriver = SeleniumDriver;
+//# sourceMappingURL=SeleniumDriver.cjs.map

package/UNSAFE_SeleniumDriver/SeleniumDriver.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeleniumDriver.cjs","sources":["../../src/UNSAFE_SeleniumDriver/SeleniumDriver.ts"],"sourcesContent":["import {\n  type ClickOptions,\n  type KeyType,\n  TestDriverBase,\n  type TestElement,\n  getTimeouts\n} from '@oracle/oraclejet-testing/UNSAFE_Driver';\nimport { Keys as TestingKeys } from '@oracle/oraclejet-testing/UNSAFE_Driver';\nimport { ElementLocator } from '@oracle/oraclejet-testing/UNSAFE_Locators';\nimport { By, Key as WebDriverKeys, WebDriver, WebElement } from 'selenium-webdriver';\n\ntype WaitForElementType = (\n  locator: ElementLocator,\n  parent: WebDriver | WebElement\n) => Promise<TestElement>;\n\ntype WaitForElementsType = (\n  locator: ElementLocator,\n  parent: WebDriver | WebElement\n) => Promise<TestElement[]>;\n\nconst modifierKeys = {\n  SHIFT: WebDriverKeys.SHIFT,\n  CONTROL: WebDriverKeys.CONTROL,\n  CONTROL_COMMAND: WebDriverKeys.CONTROL,\n  ALT: WebDriverKeys.ALT\n};\n\nconst keyMap: { [key: string]: string } = {\n  ...modifierKeys,\n  BACKSPACE: WebDriverKeys.BACK_SPACE,\n  TAB: WebDriverKeys.TAB,\n  ENTER: WebDriverKeys.ENTER,\n  ESCAPE: WebDriverKeys.ESCAPE,\n  PAGE_UP: WebDriverKeys.PAGE_UP,\n  PAGE_DOWN: WebDriverKeys.PAGE_DOWN,\n  END: WebDriverKeys.END,\n  HOME: WebDriverKeys.HOME,\n  ARROW_LEFT: WebDriverKeys.ARROW_LEFT,\n  ARROW_UP: WebDriverKeys.ARROW_UP,\n  ARROW_RIGHT: WebDriverKeys.ARROW_RIGHT,\n  ARROW_DOWN: WebDriverKeys.ARROW_DOWN,\n  DELETE: WebDriverKeys.DELETE,\n\n  F1: WebDriverKeys.F1,\n  F2: WebDriverKeys.F2,\n  F3: WebDriverKeys.F3,\n  F4: WebDriverKeys.F4,\n  F5: WebDriverKeys.F5,\n  F6: WebDriverKeys.F6,\n  F7: WebDriverKeys.F7,\n  F8: WebDriverKeys.F8,\n  F9: WebDriverKeys.F9,\n  F10: WebDriverKeys.F10,\n  F11: WebDriverKeys.F11,\n  F12: WebDriverKeys.F12\n};\n\nlet currentScriptTimeout: number | undefined;\n\nexport class SeleniumDriver extends TestDriverBase {\n  private _driver: WebDriver;\n  private _platform = '';\n\n  constructor(driver: WebDriver) {\n    super();\n    this._driver = driver;\n  }\n\n  async executeScript<T>(script: string | ((...args: any) => T), ...args: any): Promise<T> {\n    await this._setDriverTimeouts();\n    return this._driver.executeScript<T>(script, ...args);\n  }\n\n  async waitForElement(locator: ElementLocator): Promise<TestElement> {\n    return this._waitForElement(locator, this._driver);\n  }\n\n  async waitForElements(locator: ElementLocator): Promise<TestElement[]> {\n    return this._waitForElements(locator, this._driver);\n  }\n\n  private _waitForElement = async (locator: ElementLocator, parent: WebDriver | WebElement) => {\n    try {\n      const el = await this.waitFor<Promise<WebElement>>(\n        () => parent.findElement(By.css(locator.css)),\n        {\n          timeout: getTimeouts().elementExistsTimeout\n        }\n      );\n      return Promise.resolve(wrapElement(el, this._waitForElement, this._waitForElements));\n    } catch {\n      throw Error(`No element matching query \"${JSON.stringify(locator)}\"`);\n    }\n  };\n\n  private _waitForElements = async (locator: ElementLocator, parent: WebDriver | WebElement) => {\n    let matches: WebElement[] | undefined;\n    try {\n      // loop to find at least 1 match\n      matches = await this.waitFor<WebElement[] | undefined>(\n        async () => {\n          const all = await parent.findElements(By.css(locator.css));\n          if (all.length) {\n            return all;\n          }\n          return;\n        },\n        {\n          timeout: getTimeouts().elementExistsTimeout\n        }\n      );\n    } catch {\n      return [];\n    }\n    return Promise.resolve(\n      Array.from(matches || []).map((m) =>\n        wrapElement(m, this._waitForElement, this._waitForElements)\n      )\n    );\n  };\n\n  /**\n   * Get a TestElement for the given WebElement\n   * @param from The WebElement\n   * @returns A TestElement\n   */\n  getTestElement(from: WebElement) {\n    return wrapElement(from, this._waitForElement, this._waitForElements);\n  }\n\n  async sendKeys(element: TestElement, ...text: (string | KeyType)[]): Promise<void> {\n    await this._ensurePlatform();\n    return this.unwrapElement(element).sendKeys(\n      ...text.map<string>(this._getPlatformKey.bind(this))\n    );\n  }\n\n  async click(element: TestElement, options: ClickOptions = {}) {\n    await this._ensurePlatform();\n    const modifiers = options.modifiers || [];\n    const actions = this._driver.actions();\n    if (modifiers) {\n      modifiers.map(this._getPlatformKey.bind(this)).forEach((m) => actions.keyDown(m));\n      await actions.perform();\n    }\n    await this.unwrapElement(element).click();\n    return actions.clear();\n  }\n\n  unwrapElement<T = WebElement>(element: TestElement): T {\n    return (element as TestElementImpl)._el as T;\n  }\n\n  private async _ensurePlatform() {\n    if (!this._platform) {\n      this._platform = (await this._driver.getCapabilities()).getPlatform() || 'unknown';\n    }\n  }\n\n  /**\n   * Get the platform-specific key value for the key, if available.\n   * @param key The key value\n   * @returns A platform-specific value for the key, or the original key if none exists\n   */\n  private _getPlatformKey(key: string | KeyType) {\n    if (typeof key === 'object') {\n      return TestingKeys.CONTROL_COMMAND === key\n        ? this._platform === 'mac'\n          ? WebDriverKeys.COMMAND\n          : WebDriverKeys.CONTROL\n        : keyMap[key.key];\n    }\n    return key;\n  }\n\n  private _setDriverTimeouts() {\n    const { scriptTimeout } = getTimeouts();\n    if (scriptTimeout !== currentScriptTimeout) {\n      currentScriptTimeout = scriptTimeout;\n      // set script timeout\n      // we don't set implicit (waitForElement) because we want to enforce our own behavior\n      return this._driver.manage().setTimeouts({\n        script: scriptTimeout\n      });\n    }\n    return;\n  }\n}\n\nfunction wrapElement(\n  element: WebElement,\n  waitForElement: WaitForElementType,\n  waitForElements: WaitForElementsType\n) {\n  return new TestElementImpl(element, waitForElement, waitForElements);\n}\n\nclass TestElementImpl implements TestElement {\n  _el: WebElement;\n  _waitForElement: WaitForElementType;\n  _waitForElements: WaitForElementsType;\n\n  constructor(\n    element: WebElement,\n    waitForElement: WaitForElementType,\n    waitForElements: WaitForElementsType\n  ) {\n    this._el = element;\n    this._waitForElement = waitForElement;\n    this._waitForElements = waitForElements;\n  }\n  waitForElement(locator: ElementLocator): Promise<TestElement> {\n    return this._waitForElement(locator, this._el);\n  }\n  waitForElements(locator: ElementLocator): Promise<TestElement[]> {\n    return this._waitForElements(locator, this._el);\n  }\n  getAttribute(attrName: string): Promise<string | null> {\n    return this._el.getAttribute(attrName);\n  }\n}\n"],"names":["WebDriverKeys","TestDriverBase","By","getTimeouts","TestingKeys"],"mappings":"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"}

package/UNSAFE_SeleniumDriver/SeleniumDriver.d.ts

@@ -0,0 +1,42 @@
+import { type ClickOptions, type KeyType, TestDriverBase, type TestElement } from '@oracle/oraclejet-testing/UNSAFE_Driver';
+import { ElementLocator } from '@oracle/oraclejet-testing/UNSAFE_Locators';
+import { WebDriver, WebElement } from 'selenium-webdriver';
+type WaitForElementType = (locator: ElementLocator, parent: WebDriver | WebElement) => Promise<TestElement>;
+type WaitForElementsType = (locator: ElementLocator, parent: WebDriver | WebElement) => Promise<TestElement[]>;
+export declare class SeleniumDriver extends TestDriverBase {
+    private _driver;
+    private _platform;
+    constructor(driver: WebDriver);
+    executeScript<T>(script: string | ((...args: any) => T), ...args: any): Promise<T>;
+    waitForElement(locator: ElementLocator): Promise<TestElement>;
+    waitForElements(locator: ElementLocator): Promise<TestElement[]>;
+    private _waitForElement;
+    private _waitForElements;
+    /**
+     * Get a TestElement for the given WebElement
+     * @param from The WebElement
+     * @returns A TestElement
+     */
+    getTestElement(from: WebElement): TestElementImpl;
+    sendKeys(element: TestElement, ...text: (string | KeyType)[]): Promise<void>;
+    click(element: TestElement, options?: ClickOptions): Promise<void>;
+    unwrapElement<T = WebElement>(element: TestElement): T;
+    private _ensurePlatform;
+    /**
+     * Get the platform-specific key value for the key, if available.
+     * @param key The key value
+     * @returns A platform-specific value for the key, or the original key if none exists
+     */
+    private _getPlatformKey;
+    private _setDriverTimeouts;
+}
+declare class TestElementImpl implements TestElement {
+    _el: WebElement;
+    _waitForElement: WaitForElementType;
+    _waitForElements: WaitForElementsType;
+    constructor(element: WebElement, waitForElement: WaitForElementType, waitForElements: WaitForElementsType);
+    waitForElement(locator: ElementLocator): Promise<TestElement>;
+    waitForElements(locator: ElementLocator): Promise<TestElement[]>;
+    getAttribute(attrName: string): Promise<string | null>;
+}
+export {};