npm - @oracle/oraclejet-webdriver - Versions diffs - 17.1.4 → 18.0.1 - Mend

@oracle/oraclejet-webdriver 17.1.4 → 18.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (922) hide show

package/lib/busy-context-utils.js CHANGED Viewed

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pageReady = exports.whenBusyContextReady = exports.getBusyStates = void 0;
+exports.whenBusyContextReady = exports.getBusyStates = void 0;
+exports.pageReady = pageReady;
 const selenium_webdriver_1 = require("selenium-webdriver");
 const oj_module_proxy_1 = require("./oj-module-proxy");
 /**
@@ -12,7 +13,7 @@ const oj_module_proxy_1 = require("./oj-module-proxy");
 const getBusyStates = async (driver) => {
     const hasProxy = await driver.executeScript(`return '${oj_module_proxy_1.TEST_OBJ_NAME}' in window`);
     if (hasProxy) {
-        return (0, oj_module_proxy_1.executeWithModules)(driver, ['BusyContext'], [], '(BusyContext) => BusyContext.getBusyStates().map((state) => state.description)').catch((ex) => ex.message);
+        return (0, oj_module_proxy_1.executeWithModules)(driver, ['BusyContext'], [], (BusyContext) => BusyContext.getBusyStates().map((state) => state.description)).catch((ex) => ex.message);
     }
     return '';
 };
@@ -27,7 +28,7 @@ exports.getBusyStates = getBusyStates;
  * page's busy state is ready or to false when it is not a JET page.
  */
 const whenBusyContextReady = async (driver) => {
-    return (0, oj_module_proxy_1.executeWithModules)(driver, ['BusyContext'], [], '(BusyContext) => BusyContext.whenReady()').catch(async (ex) => {
+    return (0, oj_module_proxy_1.executeWithModules)(driver, ['BusyContext'], [], (BusyContext) => BusyContext.whenReady()).catch(async (ex) => {
         if (ex instanceof selenium_webdriver_1.error.TimeoutError || ex instanceof selenium_webdriver_1.error.ScriptTimeoutError) {
             const openStates = await (0, exports.getBusyStates)(driver);
             throw Error(`BusyContext.whenReady() timed out: ${ex.message}\nBusy states: ${openStates}`);
@@ -46,15 +47,14 @@ function pageReady() {
     return new selenium_webdriver_1.Condition('for JET page to indicate ready', async (driver) => {
         // Check that <html> element has a size after page ready
         // Call thru executeScript to bypass WebElement overrides
-        const size = await driver.executeScript(`
-      const html = document.querySelector('html');
-      return { width: html.clientWidth, height: html.clientHeight }
-    `);
+        const size = await driver.executeScript(() => {
+            const html = document.querySelector('html');
+            return { width: html?.clientWidth, height: html?.clientHeight };
+        });
         if (!(size.width && size.height)) {
             return Promise.resolve(false);
         }
         return (0, exports.whenBusyContextReady)(driver);
     });
 }
-exports.pageReady = pageReady;
 //# sourceMappingURL=busy-context-utils.js.map

package/lib/busy-context-utils.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"busy-context-utils.js","sourceRoot":"","sources":["~~../../~~lib/busy-context-utils.ts"],"names":[],"mappings":";;;~~AAAA~~,2DAAiE;AACjE,uDAAsE;AAEtE;;;;;GAKG;AACI,MAAM,aAAa,GAAG,KAAK,EAAE,MAAiB,EAAmB,EAAE;IACxE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,CAAU,WAAW,+BAAa,aAAa,CAAC,CAAC;IAC5F,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,IAAA,oCAAkB,~~EACvB~~,MAAM,~~EACN~~,CAAC,aAAa,CAAC,~~EACf~~,EAAE,~~EACF~~,~~gFAAgF~~,~~CACjF~~,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;~~AAXW~~,QAAA,aAAa,~~iBAWxB~~;AAEF;;;;;;;;GAQG;AACI,MAAM,oBAAoB,GAAG,KAAK,EAAE,MAAiB,EAAoB,EAAE;IAChF,OAAO,IAAA,oCAAkB,~~EACvB~~,MAAM,~~EACN~~,CAAC,aAAa,CAAC,~~EACf~~,EAAE,~~EACF~~,~~0CAA0C~~,~~CAC3C~~,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACnB,IAAI,EAAE,YAAY,0BAAK,CAAC,YAAY,IAAI,EAAE,YAAY,0BAAK,CAAC,kBAAkB,EAAE,CAAC;YAC/E,MAAM,UAAU,GAAG,MAAM,IAAA,qBAAa,EAAC,MAAM,CAAC,CAAC;YAC/C,MAAM,KAAK,CAAC,sCAAsC,EAAE,CAAC,OAAO,kBAAkB,UAAU,EAAE,CAAC,CAAC;QAC9F,CAAC;aAAM,CAAC;YACN,6DAA6D;YAC7D,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;~~AAfW~~,QAAA,oBAAoB,~~wBAe~~/B;AAEF;;GAEG;AACH,SAAgB,SAAS;IACvB,OAAO,IAAI,8BAAS,CAAmB,gCAAgC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxF,wDAAwD;QACxD,yDAAyD;QACzD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,CAAoC~~;;;KAG1E~~,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,IAAA,4BAAoB,EAAC,MAAM,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC~~;AAdD,8BAcC~~"}
1	+ {"version":3,"file":"busy-context-utils.js","sourceRoot":"","sources":["../src/lib/busy-context-utils.ts"],"names":[],"mappings":";;;AA6CA,8BAcC;AA3DD,2DAAiE;AACjE,uDAAsE;AAEtE;;;;;GAKG;AACI,MAAM,aAAa,GAAG,KAAK,EAAE,MAAiB,EAAmB,EAAE;IACxE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,CAAU,WAAW,+BAAa,aAAa,CAAC,CAAC;IAC5F,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,IAAA,oCAAkB,EAAS,MAAM,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,EAAE,EAAE,CAC7E,WAAW,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,KAA8B,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CACvF,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AARW,QAAA,aAAa,iBAQxB;AAEF;;;;;;;;GAQG;AACI,MAAM,oBAAoB,GAAG,KAAK,EAAE,MAAiB,EAAoB,EAAE;IAChF,OAAO,IAAA,oCAAkB,EAAU,MAAM,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,EAAE,EAAE,CAC9E,WAAW,CAAC,SAAS,EAAE,CACxB,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACnB,IAAI,EAAE,YAAY,0BAAK,CAAC,YAAY,IAAI,EAAE,YAAY,0BAAK,CAAC,kBAAkB,EAAE,CAAC;YAC/E,MAAM,UAAU,GAAG,MAAM,IAAA,qBAAa,EAAC,MAAM,CAAC,CAAC;YAC/C,MAAM,KAAK,CAAC,sCAAsC,EAAE,CAAC,OAAO,kBAAkB,UAAU,EAAE,CAAC,CAAC;QAC9F,CAAC;aAAM,CAAC;YACN,6DAA6D;YAC7D,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAZW,QAAA,oBAAoB,wBAY/B;AAEF;;GAEG;AACH,SAAgB,SAAS;IACvB,OAAO,IAAI,8BAAS,CAAmB,gCAAgC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxF,wDAAwD;QACxD,yDAAyD;QACzD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,CAAoC,GAAG,EAAE;YAC9E,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAC5C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QAClE,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,IAAA,4BAAoB,EAAC,MAAM,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/lib/dataprovider-utils.d.ts ADDED Viewed

@@ -0,0 +1,40 @@
+import { DataProvider, DataFilter } from '@oracle/oraclejet/ojdataprovider';
+import { OjWebElement } from '../elements';
+type FilterFlags<Base, Condition> = {
+    [Key in keyof Base]: Base[Key] extends Condition ? Key : never;
+};
+type AllowedNames<Base, Condition> = FilterFlags<Base, Condition>[keyof Base];
+type SubType<Base, Condition> = Pick<Base, AllowedNames<Base, Condition>>;
+/**
+ * Get the key for the record filtered by filterDef. If exactly one record is
+ * found after filtering is applied, the key of that record is returned.
+ * An error is thrown if, after filtering:
+ * - no records are found
+ * - more than one record is found
+ * If the property identified by dataProviderProp doesn't exist or is not a DataProvider,
+ * an error will be also thrown.
+ * @typeParam E - Custom element type
+ * @typeParam K - Type of key value
+ * @typeParam DataProviderProps - Type representing DataProvider-valued properties of the custom element type
+ * @param el The OjWebElement whose properties reference the DataProvider
+ * @param dataProviderProp The property name within the element identifying the DataProvider
+ * @param filterDef A [FilterDef](https://www.oracle.com/webfolder/technetwork/jet/jsdocs/DataFilter.html#FilterDef)
+ * used to locate the record within the DataProvider
+ * @return {K} The key of the matching record
+ *
+ * #### Example Usage
+ * Fetch a key from a SelectSingle DataProvider by filtering for a DepartmentName
+ * ```javascript
+ * import { fetchKeyByFilter } from '@oracle/oraclejet-webdriver';
+ * import { ojSelectSingle as JetSelectSingle } from '@oracle/oraclejet/ojselectsingle';
+ * const ss1 = await ojSelectSingle(driver, By.id('department-select'));
+ * const key = fetchKeyByFilter<JetSelectSingle<string,any>,string>(ss1, 'data', {
+ *   op: '$eq',
+ *   value: { DepartmentName: 'Finance' }
+ * });
+ * await ss1.changeValue(key);
+ * ```
+ */
+export declare function fetchKeyByFilter<E, K, DataProviderProps = keyof SubType<E, DataProvider<K, any>>>(el: OjWebElement, dataProviderProp: DataProviderProps, filterDef: DataFilter.FilterDef<any>): Promise<K>;
+export {};

package/lib/dataprovider-utils.js CHANGED Viewed

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchKeyByFilter = void 0;
+exports.fetchKeyByFilter = fetchKeyByFilter;
 const oj_module_proxy_1 = require("./oj-module-proxy");
 /**
  * Get the key for the record filtered by filterDef. If exactly one record is
@@ -35,34 +35,28 @@ const oj_module_proxy_1 = require("./oj-module-proxy");
  */
 async function fetchKeyByFilter(el, dataProviderProp, filterDef) {
     await el.whenBusyContextReady();
-    return (0, oj_module_proxy_1.executeWithModules)(el.getDriver(), ['CustomElementUtils'], [el, dataProviderProp, filterDef], `
-    (({ getElementProperty }, comp, dataProviderProp, filterDef) => {
-      return new Promise((resolve, reject) => {
-        const dp = getElementProperty(comp, dataProviderProp);
-        if (!(dp && typeof dp.fetchFirst === 'function')) {
-          reject('Property "${dataProviderProp}" does not reference a supported DataProvider');
-        }
-        const iter = dp.fetchFirst({
-          filterCriterion: filterDef
-        })[Symbol.asyncIterator]();
-        iter.next().then(res => {
-          if (res.value.metadata.length === 1) {
-            resolve(res.value.metadata[0].key);
-          }
-          else if (res.value.metadata.length > 1) {
-            reject('Filter returned too many keys: ' + res.value.metadata.map(r => r.key));
-          }
-          else {
-            reject('Filter returned no keys');
-          }
+    return (0, oj_module_proxy_1.executeWithModules)(el.getDriver(), ['CustomElementUtils'], [el, dataProviderProp, filterDef], ({ getElementProperty }, comp, dataProviderProp, filterDef) => {
+        return new Promise((resolve, reject) => {
+            const dp = getElementProperty(comp, dataProviderProp);
+            if (!(dp && typeof dp.fetchFirst === 'function')) {
+                reject('Property "${dataProviderProp}" does not reference a supported DataProvider');
+            }
+            const iter = dp
+                .fetchFirst({
+                filterCriterion: filterDef
+            })[Symbol.asyncIterator]();
+            iter.next().then((res) => {
+                if (res.value.metadata.length === 1) {
+                    resolve(res.value.metadata[0].key);
+                }
+                else if (res.value.metadata.length > 1) {
+                    reject('Filter returned too many keys: ' + res.value.metadata.map((r) => r.key));
+                }
+                else {
+                    reject('Filter returned no keys');
+                }
+            });
         });
-      });
-    })
-  `);
+    });
 }
-exports.fetchKeyByFilter = fetchKeyByFilter;
 //# sourceMappingURL=dataprovider-utils.js.map

package/lib/dataprovider-utils.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"dataprovider-utils.js","sourceRoot":"","sources":["~~../../~~lib/dataprovider-utils.ts"],"names":[],"mappings":"~~;;;AAEA~~,uDAAuD;AAUvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACI,KAAK,UAAU,gBAAgB,CAKpC,EAAgB,EAChB,gBAAmC,EACnC,SAAoC;IAEpC,MAAM,EAAE,CAAC,oBAAoB,EAAE,CAAC;IAEhC,OAAO,IAAA,oCAAkB,EACvB,EAAE,CAAC,SAAS,EAAE,EACd,CAAC,oBAAoB,CAAC,EACtB,CAAC,EAAE,EAAE,gBAAgB,EAAE,SAAS,CAAC,EACjC~~;;;;;;8BAM0B~~,gBAAgB~~;;;;;;;;;;;;;;;;;;;;;GAqB3C~~,~~CACA~~,CAAC;~~AACJ~~,CAAC;~~AA5CD~~,~~4CA4CC~~"}
1	+ {"version":3,"file":"dataprovider-utils.js","sourceRoot":"","sources":["../src/lib/dataprovider-utils.ts"],"names":[],"mappings":";;AA2CA,4CAwCC;AAjFD,uDAAuD;AAUvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACI,KAAK,UAAU,gBAAgB,CAKpC,EAAgB,EAChB,gBAAmC,EACnC,SAAoC;IAEpC,MAAM,EAAE,CAAC,oBAAoB,EAAE,CAAC;IAEhC,OAAO,IAAA,oCAAkB,EACvB,EAAE,CAAC,SAAS,EAAE,EACd,CAAC,oBAAoB,CAAC,EACtB,CAAC,EAAE,EAAE,gBAAgB,EAAE,SAAS,CAAC,EACjC,CAAC,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAc,EAAE;QACxE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;YACtD,IAAI,CAAC,CAAC,EAAE,IAAI,OAAO,EAAE,CAAC,UAAU,KAAK,UAAU,CAAC,EAAE,CAAC;gBACjD,MAAM,CAAC,4EAA4E,CAAC,CAAC;YACvF,CAAC;YAED,MAAM,IAAI,GAAG,EAAE;iBACZ,UAAU,CAAC;gBACV,eAAe,EAAE,SAAS;aAC3B,CAAC,CACD,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;YAE3B,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,GAAQ,EAAE,EAAE;gBAC5B,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACpC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBACrC,CAAC;qBAAM,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzC,MAAM,CAAC,iCAAiC,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACxF,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,yBAAyB,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC"}

package/lib/driver-manager.d.ts ADDED Viewed

@@ -0,0 +1,211 @@
+import { Builder, Capabilities, WebDriver } from 'selenium-webdriver';
+interface Timeouts {
+    /**
+     * The timeout value for script execution.  Default 30000
+     */
+    script?: number;
+    /**
+     * The timeout value for page loading (and to be ready).  Default 30000
+     */
+    pageLoad?: number;
+    /**
+     * The timeout value for finding an element on the page.  Default 0
+     */
+    implicit?: number;
+}
+interface CapabilitiesConfiguration {
+    /**
+     * The WebDriver Capabilties for the configuration
+     */
+    capabilities?: Capabilities | Map<string, any> | {};
+    /**
+     * The WebDriver timeout values for the configuration
+     */
+    timeouts?: Timeouts;
+}
+/**
+ * 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-webdriver";
+ *
+ * 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-webdriver";
+ *
+ * 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
+ *   }
+ * });
+ * ```
+ *
+ */
+export declare class DriverManager {
+    /**
+     * Optionally set the [Builder]
+     * (https://seleniumhq.github.io/selenium/docs/api/javascript/module/selenium-webdriver/index_exports_Builder.html)
+     * 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: Builder): void;
+    /**
+     * Register a configuration for WebDriver instances. Configurations consist of
+     * [Capabilities]
+     * (https://seleniumhq.github.io/selenium/docs/api/javascript/module/selenium-webdriver/index_exports_Capabilities.html)
+     * and/or [Timeouts]
+     * (https://seleniumhq.github.io/selenium/docs/api/javascript/module/selenium-webdriver/lib/capabilities_exports_Timeouts.html).
+     * 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.
+     *
+     * ### Register a default config
+     * ```javascript
+     * DriverManager.registerConfig(
+     *   {
+     *     capabilities: new Capabilities({
+     *       browserName: "chrome"
+     *     }),
+     *     timeouts: {
+     *       implicit: 5000
+     *     }
+     *   }
+     * );
+     * ```
+     * ### Register a Firefox config
+     * ```javascript
+     * DriverManager.registerConfig(
+     *   {
+     *     capabilities: new Capabilities({
+     *       browserName: "firefox",
+     *       hideAlerts: true
+     *     })
+     *   },
+     *   "firefox-no-alerts"
+     * );
+     * ```
+     */
+    static registerConfig(config: CapabilitiesConfiguration, name?: string): void;
+    /**
+     * Get a
+     * [WebDriver](https://seleniumhq.github.io/selenium/docs/api/javascript/module/selenium-webdriver/index_exports_WebDriver.html)
+     * 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 getDriver(configName?: string): Promise<WebDriver>;
+    /**
+     * 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 getCurrentDriver(): Promise<WebDriver>;
+    /**
+     * Release the WebDriver instance from use.  Called when each test is done
+     * with its driver usage, typicall, in the Mocha <code>after</code> function.
+     * @param driver The WebDriver instance
+     */
+    static releaseDriver(driver: WebDriver): void;
+}
+export {};

package/lib/driver-manager.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"driver-manager.js","sourceRoot":"","sources":["~~../../~~lib/driver-manager.ts"],"names":[],"mappings":";;;AAAA,2DAAsE;AA2BtE;;GAEG;AACH,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B;;GAEG;AACH,MAAM,mBAAmB,GAAG,IAAI,iCAAY,CAAC;IAC3C,WAAW,EAAE,IAAI;IACjB,WAAW,EAAE,QAAQ;CACtB,CAAC,CAAC;AACH;;GAEG;AACH,MAAM,eAAe,GAAa;IAChC,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,KAAK;IACf,MAAM,EAAE,KAAK;CACd,CAAC;AACF;;GAEG;AACH,MAAM,OAAO,GAAiD,EAAE,CAAC;AACjE;;GAEG;AACH,IAAI,eAAe,GAAsE;IACvF,UAAU,EAAE,SAAS;IACrB,MAAM,EAAE,SAAS;CAClB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB;;GAEG;AACH,IAAI,OAAgB,CAAC;AACrB;;;;;;GAMG;AACH,IAAI,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC7C;;GAEG;AACH,IAAI,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiFG;AACH,MAAa,aAAa;IACxB;;;;;;;;;;;;;;;OAeG;IACI,MAAM,CAAC,UAAU,CAAC,CAAU;QACjC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,KAAK,CAAC,8EAA8E,CAAC,CAAC;QAC9F,CAAC;QACD,OAAO,GAAG,CAAC,CAAC;IACd,CAAC;IACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACI,MAAM,CAAC,cAAc,CAAC,MAAiC,EAAE,IAAa;QAC3E,OAAO,CAAC,IAAI,IAAI,iBAAiB,CAAC,GAAG,MAAM,CAAC;IAC9C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,UAAmB;QAC/C,YAAY,CAAC,YAAY,CAAC,CAAC;QAC3B,UAAU,GAAG,UAAU,IAAI,iBAAiB,CAAC;QAE7C,IAAI,UAAU,KAAK,eAAe,CAAC,UAAU,EAAE,CAAC;YAC9C,wCAAwC;YACxC,IAAI,CAAC;gBACH,IAAI,eAAe,CAAC,MAAM,EAAE,CAAC;oBAC3B,MAAM,eAAe,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;oBAC7C,OAAO,eAAe,CAAC,MAAM,CAAC;gBAChC,CAAC;YACH,CAAC;YAAC,OAAO,EAAE,EAAE,CAAC,CAAA,CAAC;QACjB,CAAC;QAED,iBAAiB,EAAE,CAAC;QACpB,OAAO,YAAY,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,CAAC,gBAAgB;QAClC,OAAO,aAAa,CAAC,SAAS,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;IAC7D,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,aAAa,CAAC,MAAiB;QAC3C,YAAY,CAAC,YAAY,CAAC,CAAC;QAC3B,0EAA0E;QAC1E,yEAAyE;QACzE,yBAAyB;QACzB,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;IACjE,CAAC;CACF;AAxID,sCAwIC;AACD,aAAa,CAAC,cAAc,CAAC,EAAE,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;AAE/F;;;;;;;GAOG;AACH,SAAS,YAAY,CAAC,UAAkB;IACtC,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,KAAK,CAAC,uCAAuC,UAAU,GAAG,CAAC,CAAC;IACpE,CAAC;IACD,8CAA8C;IAC9C,MAAM,IAAI,GAAG,IAAI,iCAAY,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,YAAY,CAAC,CAAC;IACvE,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC;IACD,0CAA0C;IAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,4BAAO,EAAE,CAAC;IAC1B,CAAC;~~IACD~~,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;QACjC,MAAM,MAAM,~~GAAc~~,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;~~QACjE~~,eAAe,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QACzC,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC5C,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB;IACxB,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,MAAkB;IACpC,IAAI,MAAM,EAAE,CAAC;QACX,eAAe,GAAG;YAChB,UAAU,EAAE,SAAS;YACrB,MAAM,EAAE,SAAS;SAClB,CAAC;QACF,WAAW,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC"}
1	+ {"version":3,"file":"driver-manager.js","sourceRoot":"","sources":["../src/lib/driver-manager.ts"],"names":[],"mappings":"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"}

package/lib/driver-override.d.ts ADDED Viewed

@@ -0,0 +1,8 @@
+import { WebElement } from 'selenium-webdriver';
+import { OjWebElement, ElementLocators } from '../elements/OjWebElement';
+/**
+ * Register a constructor for a custom WebElement for a given tag name.
+ * @param tagName The DOM tag name for the custom element
+ * @param ctor The constructor function for the custom WebElement
+ */
+export declare function register(tagName: string, ctor: new (el: WebElement, locators: ElementLocators) => OjWebElement): void;

package/lib/driver-override.js CHANGED Viewed

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.register = void 0;
+exports.register = register;
 // @ts-nocheck
 const selenium_webdriver_1 = require("selenium-webdriver");
+const WebDriverErrors = require("selenium-webdriver/lib/error");
 // Import OjWebElement directly from its file rather than through
 // 'elements' package, to avoid circular dependency (elements will
 // call to register themselves upon loading)
@@ -17,7 +18,6 @@ const busy_context_utils_1 = require("./busy-context-utils");
 function register(tagName, ctor) {
     WebElementRegistry.register(tagName, ctor);
 }
-exports.register = register;
 /**
  * Holds the value of the last page-type check. Updated each time when
  * WebDriver.findElement / findElements is called because any subsequent action
@@ -63,6 +63,18 @@ selenium_webdriver_1.WebElement.prototype.findElement = wrapFindElement(selenium
 selenium_webdriver_1.WebElement.prototype.findElements = wrapFindElements(selenium_webdriver_1.WebElement.prototype.findElements);
 selenium_webdriver_1.WebDriver.prototype.executeScript = wrapExecuteScript(selenium_webdriver_1.WebDriver.prototype.executeScript);
 selenium_webdriver_1.WebDriver.prototype.executeAsyncScript = wrapExecuteScript(selenium_webdriver_1.WebDriver.prototype.executeAsyncScript);
+/**
+ * Get a mapping of WebDriver error class names to error class instances
+ * @returns { errorClassName: errorClassInstance, ... }
+ */
+function getWebDriverErrors() {
+    return Object.keys(WebDriverErrors)
+        .filter((c) => c.match(/^[A-Z].+Error$/))
+        .reduce((accum, className) => {
+        accum[className] = new WebDriverErrors[className]();
+        return accum;
+    }, {});
+}
 /**
  * Create a wrapper for findElement()
  * @param origFunc The original findElement function
@@ -73,6 +85,8 @@ function wrapFindElement(origFunc) {
         const isDriver = this instanceof selenium_webdriver_1.WebDriver;
         const driver = isDriver ? this : this.getDriver();
         return new selenium_webdriver_1.WebElementPromise(driver, new Promise(async (resolve, reject) => {
+            // create an error before calling async webdriver command to retain original stack from test
+            const webdriverErrors = getWebDriverErrors();
             try {
                 // Only inspect page when called by driver object (not from WebElement)
                 lastIsJetPage = isDriver ? await isJetPage(this) : lastIsJetPage;
@@ -88,7 +102,10 @@ function wrapFindElement(origFunc) {
                 }
             }
             catch (ex) {
-                reject(ex);
+                const errorWithStack = webdriverErrors[ex.name] || ex;
+                errorWithStack.name = ex.name;
+                errorWithStack.message = ex.message;
+                reject(errorWithStack);
             }
         }));
     };
@@ -134,7 +151,7 @@ function wrapFindElements(origFunc) {
  * @private
  */
 function wrapExecuteScript(origFunc) {
-    return async function (...args) {
+    return async function executeScript(...args) {
         try {
             const ret = await origFunc.apply(this, args);
             return ret;
@@ -143,8 +160,7 @@ function wrapExecuteScript(origFunc) {
             if (ex instanceof selenium_webdriver_1.error.StaleElementReferenceError) {
                 const newArgs = [];
                 const locators = [];
-                for (let i = 0, len = args.length; i < len; i++) {
-                    let arg = args[i];
+                for (let arg of args) {
                     // Requery arguments which are OjWebElements
                     if (arg instanceof OjWebElement_1.OjWebElement) {
                         arg = await (0, stale_element_1.requeryElement)(arg);
@@ -153,7 +169,7 @@ function wrapExecuteScript(origFunc) {
                     newArgs.push(arg);
                 }
                 console.warn(`Trapped stale element executing script on ${locators}`);
-                return origFunc.apply(this, newArgs);
+                return executeScript.apply(this, newArgs);
             }
             throw ex;
         }
@@ -167,7 +183,7 @@ function wrapExecuteScript(origFunc) {
  * on an existing element reference within the same page.
  *
  * @param driver WebDriver instance
- * @returns {boolean} Returns true if JET page, false otherwise
+ * @returns {Promise<boolean>} Returns true if JET page, false otherwise
  * @private
  */
 async function isJetPage(driver) {

package/lib/driver-override.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"driver-override.js","sourceRoot":"","sources":["~~../../~~lib/driver-override.ts"],"names":[],"mappings":"~~;;;AAAA~~,cAAc;AACd,2DAA8F;~~AAE9F~~,iEAAiE;AACjE,kEAAkE;AAClE,4CAA4C;AAC5C,2DAAyE;AACzE,mDAAiD;AACjD,6DAA4D;~~AAE5D~~;;;;GAIG;AACH,SAAgB,QAAQ,CACtB,OAAe,EACf,IAAqE;IAErE,kBAAkB,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC;~~AALD,4BAKC;~~AAED;;;;;;;;GAQG;AACH,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B;;;;;GAKG;AACH,MAAM,kBAAkB;IACtB;;;;OAIG;IACI,MAAM,CAAC,QAAQ,CACpB,OAAe,EACf,IAAqE;QAErE,kBAAkB,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC;IAChE,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,GAAG,CACf,OAAe;QAEf,OAAO,kBAAkB,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAChE,CAAC;;AACD;;GAEG;AACY,+BAAY,GAEvB,EAAE,CAAC;AAGT,8BAAS,CAAC,SAAS,CAAC,WAAW,GAAG,eAAe,CAAC,8BAAS,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AACnF,8BAAS,CAAC,SAAS,CAAC,YAAY,GAAG,gBAAgB,CAAC,8BAAS,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;AAEtF,+BAAU,CAAC,SAAS,CAAC,WAAW,GAAG,eAAe,CAAC,+BAAU,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AACrF,+BAAU,CAAC,SAAS,CAAC,YAAY,GAAG,gBAAgB,CAAC,+BAAU,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;AAExF,8BAAS,CAAC,SAAS,CAAC,aAAa,GAAG,iBAAiB,CAAC,8BAAS,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;AACzF,8BAAS,CAAC,SAAS,CAAC,kBAAkB,GAAG,iBAAiB,CAAC,8BAAS,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;AAEnG;;;;GAIG;AACH,SAAS,eAAe,CAAC,QAAiD;IACxE,OAAO,SAAS,WAAW,CAAkB,OAAgB;QAC3D,MAAM,QAAQ,GAAG,IAAI,YAAY,8BAAS,CAAC;QAC3C,MAAM,MAAM,GAAc,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,~~IAAY~~,CAAC,SAAS,EAAE,CAAC;~~QACtE~~,OAAO,IAAI,sCAAiB,CAC1B,MAAM,EACN,IAAI,OAAO,CAAa,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;YAChD,IAAI,CAAC;gBACH,uEAAuE;gBACvE,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;gBACjE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC9C,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAE,IAAY,CAAC,CAAC,CAAC,SAAS,CAAC;gBACvD,IAAI,CAAC;oBACH,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,iBAAiB,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC/E,CAAC;gBAAC,OAAO,EAAE,EAAE,CAAC;oBACZ,qFAAqF;oBACrF,6CAA6C;oBAC7C,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;YAAC,OAAO,EAAE,EAAE,CAAC;gBACZ,MAAM,CAAC,EAAE,CAAC,CAAC;~~YACb~~,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AACD;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,QAAqD;IAC7E,OAAO,KAAK,UAAU,YAAY,CAAkB,OAAgB;QAClE,MAAM,QAAQ,GAAG,IAAI,YAAY,8BAAS,CAAC;QAC3C,uEAAuE;QACvE,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;QACjE,8DAA8D;QAC9D,MAAM,KAAK,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAE,IAAY,CAAC,CAAC,CAAC,SAAS,CAAC;QACpD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,SAAS,GAAiB,EAAE,CAAC;QACjC,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;gBACvD,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBAChB,IAAI,CAAC;oBACH,MAAM,EAAE,GAAG,MAAM,iBAAiB,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;oBAC1D,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACrB,CAAC;gBAAC,OAAO,EAAE,EAAE,CAAC;oBACZ,qFAAqF;oBACrF,8CAA8C;oBAC9C,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,SAAS,GAAG,OAAO,CAAC;QACtB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,QAAyC;IAClE,OAAO,KAAK,~~WAAuB~~,GAAG,IAAW;~~QAC/C~~,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAgB,IAAI,EAAE,IAAI,CAAC,CAAC;YAC5D,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,OAAO,EAAE,EAAE,CAAC;YACZ,IAAI,EAAE,YAAY,0BAAK,CAAC,0BAA0B,EAAE,CAAC;gBACnD,MAAM,OAAO,GAAU,EAAE,CAAC;gBAC1B,MAAM,QAAQ,GAAU,EAAE,CAAC;gBAC3B,KAAK,IAAI,~~CAAC,~~GAAG,~~CAAC~~,~~EAAE,GAAG,GAAG,~~IAAI,~~CAAC,MAAM,~~EAAE,CAAC~~,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC~~;~~oBAChD~~,~~IAAI,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;oBAClB,~~4CAA4C;oBAC5C,IAAI,GAAG,YAAY,2BAAY,EAAE,CAAC;wBAChC,GAAG,GAAG,MAAM,IAAA,8BAAc,EAAC,GAAG,CAAC,CAAC;wBAChC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;oBAC1C,CAAC;oBACD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACpB,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,6CAA6C,QAAQ,EAAE,CAAC,CAAC;gBACtE,OAAO,~~QAAQ~~,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;~~YACvC~~,CAAC;YACD,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,KAAK,UAAU,SAAS,CAAC,MAAiB;IACxC,OAAO,IAAA,yCAAoB,EAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,KAAK,UAAU,iBAAiB,CAC9B,EAAc,EACd,SAAkB,EAClB,QAAuB,EACvB,aAAsB;IAEtB,uEAAuE;IACvE,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,UAAU,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,2BAAY,CAAC;IAC7D,OAAO,IAAI,IAAI,CAAC,EAAE,EAAE;QAClB,SAAS;QACT,aAAa;QACb,QAAQ;QACR,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}
1	+ {"version":3,"file":"driver-override.js","sourceRoot":"","sources":["../src/lib/driver-override.ts"],"names":[],"mappings":"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"}

package/lib/file-picker-utils.d.ts ADDED Viewed

@@ -0,0 +1,28 @@
+import { WebDriver, WebElement } from 'selenium-webdriver';
+/**
+ * This method should be called right before ojfilepickerutils.pickFiles
+ * Takes the webdriver and an Array of objects containing file paths + types.
+ * These files will be read from the local filesystem and then sent
+ * to the pickFiles method to simulate user file selection. Only the basename of
+ * the file will be sent, not the entire path to make it consistent with how
+ * the browser sets the value.
+ * @param driver the Webdriver of the test
+ * @param files An array of objects containing the path and type of selected files
+ */
+export declare const setupPickFiles: (driver: WebDriver, files: Array<{
+    path: string;
+    type: string;
+}>) => Promise<void>;
+/**
+ * Takes an Array of objects containing file paths + types.
+ * These files will be read from the local filesystem and then sent
+ * to the oj-file-picker to simulate user file selection. Only the basename of
+ * the file will be sent, not the entire path to make it consistent with how
+ * the browser sets the value.
+ * @param picker The file picker element
+ * @param files An array of objects containing the path and type of selected files
+ */
+export declare const doSelect: (picker: WebElement, files: Array<{
+    path: string;
+    type: string;
+}>) => Promise<boolean>;