@oracle/oraclejet-webdriver 17.1.3 → 18.0.0

package/{elements → src/elements}/oj-timeline/OjTimelineBase.ts

@@ -324,6 +324,10 @@ export interface MinorAxis {
    * The CSS style object defining any additional styling of the minor axis.
    */
   svgStyle: object;
+  /**
+   * An array of scales used for zooming. See the Help documentation for more information.
+   */
+  zoomOrder: Array<string | unknown>;
 }
 export interface MinorAxisConverter {
   /**
@@ -605,7 +609,7 @@ export interface Translations {
   itemResizeCancelled: string;
   /**
    * Used to indicate item end resize handle for accessibility.
-   * @deprecated Since 15.0.0. This is deprecated because it is not used by oj-timeline.
+   * @deprecated Since 15.0.0. This resource is not used by oj-timeline.
    */
   itemResizeEndHandle: string;
   /**
@@ -626,7 +630,7 @@ export interface Translations {
   itemResizeSelectionInfo: string;
   /**
    * Used to indicate item start resize handle for accessibility.
-   * @deprecated Since 15.0.0. This is deprecated because it is not used by oj-timeline.
+   * @deprecated Since 15.0.0. This resource is not used by oj-timeline.
    */
   itemResizeStartHandle: string;
   /**
@@ -651,7 +655,7 @@ export interface Translations {
   labelClearSelection: string;
   /**
    * Used to display a count out of a total.
-   * @deprecated Since 15.0.0. This is deprecated because it is not used by oj-timeline.
+   * @deprecated Since 15.0.0. This resource is not used by oj-timeline.
    */
   labelCountWithTotal: string;
   /**
@@ -704,37 +708,37 @@ export interface Translations {
   navArrowDisabledState: string;
   /**
    * Used to describe the collapsed state for accessibility.
-   * @deprecated Since 15.0.0. This is deprecated because it is not used by oj-timeline.
+   * @deprecated Since 15.0.0. This resource is not used by oj-timeline.
    */
   stateCollapsed: string;
   /**
    * Used to describe a drillable object for accessibility.
-   * @deprecated Since 15.0.0. This is deprecated because it is not used by oj-timeline.
+   * @deprecated Since 15.0.0. This resource is not used by oj-timeline.
    */
   stateDrillable: string;
   /**
    * Used to describe the expanded state for accessibility.
-   * @deprecated Since 15.0.0. This is deprecated because it is not used by oj-timeline.
+   * @deprecated Since 15.0.0. This resource is not used by oj-timeline.
    */
   stateExpanded: string;
   /**
    * Used to describe the hidden state for accessibility.
-   * @deprecated Since 15.0.0. This is deprecated because it is not used by oj-timeline.
+   * @deprecated Since 15.0.0. This resource is not used by oj-timeline.
    */
   stateHidden: string;
   /**
    * Used to describe the isolated state for accessibility.
-   * @deprecated Since 15.0.0. This is deprecated because it is not used by oj-timeline.
+   * @deprecated Since 15.0.0. This resource is not used by oj-timeline.
    */
   stateIsolated: string;
   /**
    * Used to describe the maximized state for accessibility.
-   * @deprecated Since 15.0.0. This is deprecated because it is not used by oj-timeline.
+   * @deprecated Since 15.0.0. This resource is not used by oj-timeline.
    */
   stateMaximized: string;
   /**
    * Used to describe the minimized state for accessibility.
-   * @deprecated Since 15.0.0. This is deprecated because it is not used by oj-timeline.
+   * @deprecated Since 15.0.0. This resource is not used by oj-timeline.
    */
   stateMinimized: string;
   /**
@@ -747,17 +751,17 @@ export interface Translations {
   stateUnselected: string;
   /**
    * Used to describe the visible state for accessibility.
-   * @deprecated Since 15.0.0. This is deprecated because it is not used by oj-timeline.
+   * @deprecated Since 15.0.0. This resource is not used by oj-timeline.
    */
   stateVisible: string;
   /**
    * Used for the discrete navigation mode next arrow alt text.
-   * @deprecated Since 15.0.0. This is deprecated because it is not used by oj-timeline.
+   * @deprecated Since 15.0.0. This resource is not used by oj-timeline.
    */
   tipArrowNextPage: string;
   /**
    * Used for the discrete navigation mode previous arrow alt text.
-   * @deprecated Since 15.0.0. This is deprecated because it is not used by oj-timeline.
+   * @deprecated Since 15.0.0. This resource is not used by oj-timeline.
    */
   tipArrowPreviousPage: string;
   /**

package/{elements → src/elements}/oj-tree-view/OjTreeView.ts

@@ -22,11 +22,9 @@ export class OjTreeView extends OjTreeViewBase {
       this.getDriver(),
       ['KeySet'],
       [this, selected],
-      `
-      (({ KeySetImpl }, ele, selected) => {
+      ({ KeySetImpl }, ele, selected) => {
         ele.selected = new KeySetImpl(selected);
-      })
-      `
+      }
     );
   }
   /**
@@ -39,11 +37,7 @@ export class OjTreeView extends OjTreeViewBase {
   async getSelected<K>(): Promise<Array<K>> {
     await this.whenReady();
     const selected: Array<K> = await this.getDriver().executeScript(
-      `
-        const ele = arguments[0];
-        const selected = Array.from(ele.selected.values())
-        return selected;
-      `,
+      (ele: any) => Array.from(ele.selected.values()),
       this
     );
     return selected;
@@ -61,8 +55,7 @@ export class OjTreeView extends OjTreeViewBase {
         this.getDriver(),
         ['KeyUtils'],
         [this, itemLocator.key],
-        `
-        (({ equals }, element, key) => {
+        ({ equals }, element, key) => {
           const items = element.querySelectorAll('.oj-treeview-item');
           let item;
           for (var i = 0; i < items.length; i++) {
@@ -73,19 +66,15 @@ export class OjTreeView extends OjTreeViewBase {
           }
           if (item) {
             return item.querySelector('.oj-treeview-item-content');
-          };
-        })`
+          }
+        }
       );
     } else if (itemLocator.id) {
       await this.whenBusyContextReady();
-      item = await this.getDriver().executeScript<WebElement>(
-        `
-      const item = document.getElementById(arguments[0]);
-      if (item) {
-        return item.querySelector('.oj-treeview-item-content');
-      }`,
-        itemLocator.id
-      );
+      item = await this.getDriver().executeScript<WebElement | undefined>((id: string) => {
+        const item = document.getElementById(id);
+        return item?.querySelector('.oj-treeview-item-content');
+      }, itemLocator.id);
     }
     if (item) {
       return slotProxy(item, this);
@@ -107,12 +96,10 @@ export class OjTreeView extends OjTreeViewBase {
       this.getDriver(),
       ['KeySet'],
       [this, expanded],
-      `
-      (({ ExpandedKeySet }, ele, expanded) => {
+      ({ ExpandedKeySet }, ele, expanded) => {
         const expandedKeySet = new ExpandedKeySet(expanded);
         ele.expanded = expandedKeySet;
-      })
-      `
+      }
     );
   }
   /**
@@ -149,7 +136,7 @@ export class OjTreeView extends OjTreeViewBase {
     const ins = await this._getDisclosureIcon(itemContent);
     const driver = await ins.getDriver();
     return driver.executeScript<boolean>(
-      "return arguments[0].parentNode.parentNode.classList.contains('oj-expanded')",
+      (el: any) => el.parentNode.parentNode.classList.contains('oj-expanded'),
       ins
     );
   }

package/{elements → src/elements}/oj-tree-view/OjTreeViewBase.ts

@@ -43,8 +43,8 @@ export class OjTreeViewBase extends OjWebElement {
    * @return The value of <code>scrollPolicyOptions</code> property.
    *
    */
-  public getScrollPolicyOptions(): Promise<unknown | null> {
-    return this.getProperty<unknown | null>('scrollPolicyOptions');
+  public getScrollPolicyOptions(): Promise<ScrollPolicyOptions | null> {
+    return this.getProperty<ScrollPolicyOptions | null>('scrollPolicyOptions');
   }
 
   /**
@@ -122,6 +122,12 @@ export interface DndDropItems {
   dataTypes: string | Array<string>;
 }
 export interface Item {}
+export interface ScrollPolicyOptions {
+  /**
+   * The maximum number of items to display before fetching more data items will be stopped.
+   */
+  maxCount: number;
+}
 export interface Translations {
   /**
    * Aria Label for when parent node's data has been received.
@@ -133,7 +139,7 @@ export interface Translations {
   retrievingDataAria: string;
   /**
    * Aria Label for each treeview row selector
-   * @deprecated Since 15.0.0. This is deprecated because this was a workaround for a JAWS issue that since has been fixed and is no longer used by TreeView.
+   * @deprecated Since 15.0.0. This resource was introduced as a workaround for an issue that has since been fixed, and is no longer used by oj-tree-view.
    */
   treeViewSelectorAria: string;
 }

package/{elements → src/elements}/oj-treemap/OjTreemapBase.ts

@@ -321,7 +321,7 @@ export class OjTreemapBase extends OjWebElement {
    * Gets the value of <code>touchResponse</code> property.
    * Specifies configuration options for touch and hold delays on mobile devices. See the Help documentation for more information.
    * @return The value of <code>touchResponse</code> property.
-   *
+   * @deprecated Since 18.0.0. This attribute is deprecated and no longer recommended in the Redwood Design system. The "auto" value behavior will be applied instead.
    */
   public getTouchResponse(): Promise<string> {
     return this.getProperty<string>('touchResponse');

package/{index.ts → src/index.ts}

@@ -19,6 +19,7 @@ import {
   OjFetch
 } from './lib/OjFetch';
 
+import { checkVersions } from './lib/version-check';
 import { Expectation } from './lib/Expectation';
 import * as sm from './lib/ScreenshotManager';
 import { getBusyStates, pageReady } from './lib/busy-context-utils';
@@ -64,39 +65,6 @@ export interface DriverLike {
   findElements(by: Locator): Promise<WebElement[]>;
 }
 
-/**
- * Check the running JET UI version against this oraclejet-webdriver package
- * version. It's expected that the JET UI is already fully loaded so that
- * "oj.version" and "oj.revision" will resolve.
- * If a mismatch is found, a console warning will be logged with the mismatched
- * values.
- * @param driver WebDriver instance
- * @private
- */
-async function checkVersions(driver: WebDriver) {
-  const pjson = require('./package.json');
-  const version = pjson.version;
-  const rev = pjson.config.revision;
-  const jet = await driver.executeScript<{ version: string; revision: string }>(`
-    return { version: oj.version, revision: oj.revision }
-  `);
-  if (
-    // Check if not local build (running from JET repo)
-    rev !== '#@@oj.revision@@#' &&
-    // or version mismatch
-    (version !== jet.version || rev !== jet.revision)
-  ) {
-    const mismatch = `version mismatch: oraclejet ${JSON.stringify(
-      jet
-    )}, oraclejet-webdriver {"version": "${version}", "revision": "${rev}"}`;
-    console.warn(`
-Your oraclejet UI version/revision does not match oraclejet-webdriver
-${mismatch}
-    `);
-    throw Error(mismatch);
-  }
-}
-
 /**
  * The test utility object for JET component WebElements.  This object contains
  * all of the factory functions needed to create the component WebElements, plus,

package/{lib → src/lib}/busy-context-utils.ts

@@ -10,11 +10,8 @@ import { executeWithModules, TEST_OBJ_NAME } from './oj-module-proxy';
 export const getBusyStates = async (driver: WebDriver): Promise<string> => {
   const hasProxy = await driver.executeScript<boolean>(`return '${TEST_OBJ_NAME}' in window`);
   if (hasProxy) {
-    return executeWithModules<string>(
-      driver,
-      ['BusyContext'],
-      [],
-      '(BusyContext) => BusyContext.getBusyStates().map((state) => state.description)'
+    return executeWithModules<string>(driver, ['BusyContext'], [], (BusyContext) =>
+      BusyContext.getBusyStates().map((state: { description: string }) => state.description)
     ).catch((ex) => ex.message);
   }
   return '';
@@ -30,11 +27,8 @@ export const getBusyStates = async (driver: WebDriver): Promise<string> => {
  * page's busy state is ready or to false when it is not a JET page.
  */
 export const whenBusyContextReady = async (driver: WebDriver): Promise<boolean> => {
-  return executeWithModules<boolean>(
-    driver,
-    ['BusyContext'],
-    [],
-    '(BusyContext) => BusyContext.whenReady()'
+  return executeWithModules<boolean>(driver, ['BusyContext'], [], (BusyContext) =>
+    BusyContext.whenReady()
   ).catch(async (ex) => {
     if (ex instanceof error.TimeoutError || ex instanceof error.ScriptTimeoutError) {
       const openStates = await getBusyStates(driver);
@@ -53,10 +47,10 @@ export function pageReady(): Condition<Promise<boolean>> {
   return new Condition<Promise<boolean>>('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<{ width: number; height: number }>(`
+    const size = await driver.executeScript<{ width: number; height: number }>(() => {
       const html = document.querySelector('html');
-      return { width: html.clientWidth, height: html.clientHeight }
-    `);
+      return { width: html?.clientWidth, height: html?.clientHeight };
+    });
     if (!(size.width && size.height)) {
       return Promise.resolve(false);
     }

package/{lib → src/lib}/dataprovider-utils.ts

@@ -52,37 +52,33 @@ export async function fetchKeyByFilter<
 ): Promise<K> {
   await el.whenBusyContextReady();
 
-  return executeWithModules(
+  return executeWithModules<Promise<K>>(
     el.getDriver(),
     ['CustomElementUtils'],
     [el, dataProviderProp, filterDef],
-    `
-    (({ getElementProperty }, comp, dataProviderProp, filterDef) => {
+    ({ getElementProperty }, comp, dataProviderProp, filterDef): Promise<K> => {
       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]();
+        const iter = dp
+          .fetchFirst({
+            filterCriterion: filterDef
+          })
+          [Symbol.asyncIterator]();
 
-        iter.next().then(res => {
+        iter.next().then((res: any) => {
           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 {
+          } else if (res.value.metadata.length > 1) {
+            reject('Filter returned too many keys: ' + res.value.metadata.map((r: any) => r.key));
+          } else {
             reject('Filter returned no keys');
           }
         });
       });
-
-    })
-  `
+    }
   );
 }

package/{lib → src/lib}/driver-manager.ts

@@ -325,8 +325,9 @@ function createDriver(configName: string) {
   if (!builder) {
     builder = new Builder();
   }
+
   return quitPromise.then(async () => {
-    const driver: WebDriver = builder.withCapabilities(caps).build();
+    const driver = builder.withCapabilities(caps).build();
     currentInstance = { configName, driver };
     await driver.manage().setTimeouts(timeouts);
     return driver;

package/{lib → src/lib}/driver-override.ts

@@ -1,5 +1,6 @@
 // @ts-nocheck
 import { error, Locator, WebDriver, WebElement, WebElementPromise } from 'selenium-webdriver';
+import * as WebDriverErrors from 'selenium-webdriver/lib/error';
 
 // Import OjWebElement directly from its file rather than through
 // 'elements' package, to avoid circular dependency (elements will
@@ -7,6 +8,7 @@ import { error, Locator, WebDriver, WebElement, WebElementPromise } from 'seleni
 import { OjWebElement, ElementLocators } from '../elements/OjWebElement';
 import { requeryElement } from './stale-element';
 import { whenBusyContextReady } from './busy-context-utils';
+import { checkVersions } from './version-check';
 
 /**
  * Register a constructor for a custom WebElement for a given tag name.
@@ -77,6 +79,19 @@ WebElement.prototype.findElements = wrapFindElements(WebElement.prototype.findEl
 WebDriver.prototype.executeScript = wrapExecuteScript(WebDriver.prototype.executeScript);
 WebDriver.prototype.executeAsyncScript = wrapExecuteScript(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
@@ -85,10 +100,12 @@ WebDriver.prototype.executeAsyncScript = wrapExecuteScript(WebDriver.prototype.e
 function wrapFindElement(origFunc: (locator: Locator) => WebElementPromise) {
   return function findElement(this: WebDriver, locator: Locator): WebElementPromise {
     const isDriver = this instanceof WebDriver;
-    const driver: WebDriver = isDriver ? this : (this as any).getDriver();
+    const driver: WebDriver = isDriver ? this : (this as WebElement).getDriver();
     return new WebElementPromise(
       driver,
       new Promise<WebElement>(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;
@@ -102,7 +119,10 @@ function wrapFindElement(origFunc: (locator: Locator) => WebElementPromise) {
             resolve(findElement.call(this, locator));
           }
         } catch (ex) {
-          reject(ex);
+          const errorWithStack = webdriverErrors[ex.name] || ex;
+          errorWithStack.name = ex.name;
+          errorWithStack.message = ex.message;
+          reject(errorWithStack);
         }
       })
     );
@@ -148,7 +168,7 @@ function wrapFindElements(origFunc: (locator: Locator) => Promise<WebElement[]>)
  * @private
  */
 function wrapExecuteScript(origFunc: <T>(...args: any) => Promise<T>) {
-  return async function <T>(this: T, ...args: any[]): Promise<T> {
+  return async function executeScript<T>(this: T, ...args: any[]): Promise<T> {
     try {
       const ret = await origFunc.apply<any, any[], T>(this, args);
       return ret;
@@ -156,8 +176,7 @@ function wrapExecuteScript(origFunc: <T>(...args: any) => Promise<T>) {
       if (ex instanceof error.StaleElementReferenceError) {
         const newArgs: any[] = [];
         const locators: any[] = [];
-        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) {
             arg = await requeryElement(arg);
@@ -166,7 +185,7 @@ function wrapExecuteScript(origFunc: <T>(...args: any) => Promise<T>) {
           newArgs.push(arg);
         }
         console.warn(`Trapped stale element executing script on ${locators}`);
-        return origFunc.apply(this, newArgs);
+        return executeScript.apply(this, newArgs);
       }
       throw ex;
     }
@@ -181,7 +200,7 @@ function wrapExecuteScript(origFunc: <T>(...args: any) => Promise<T>) {
  * 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: WebDriver): Promise<boolean> {

package/src/lib/file-picker-utils.ts

@@ -0,0 +1,154 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { WebDriver, WebElement } from 'selenium-webdriver';
+import { whenBusyContextReady } from './busy-context-utils';
+
+const filestoreName = '__oj_filepicker_files';
+const filenamePrefix = 'file_';
+
+// Define extension to browser window object so that we can define new properties under
+// which to store file data
+type WebDriverWindow = typeof window & { [key: string]: { [key: string]: any } };
+
+type FileData = {
+  bytes: number[];
+  path: string;
+  type: string;
+};
+
+type File = FileData & {
+  numberChunks: number;
+  chunkNumber: number;
+  fileNumber: number;
+};
+
+/**
+ * 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 const setupPickFiles = async (
+  driver: WebDriver,
+  files: Array<{ path: string; type: string }>
+) => {
+  await whenBusyContextReady(driver);
+  //create a buffer with the files
+  const dataList = files.map(({ path: filePath, type }) => {
+    const fileSizeInMB = fs.statSync(filePath).size / (1024 * 1024);
+    // webdriver has limit of 8MB per transfer; split file into 8MB chunks
+    const numberChunks = Math.ceil(fileSizeInMB / 8);
+    const fileContent = Array.from(fs.readFileSync(filePath));
+    const chunkSize = Math.floor(fileContent.length / numberChunks);
+    const fileChunks = [];
+    for (let i = 0; i < numberChunks; i++) {
+      if (i + 1 == numberChunks) {
+        fileChunks.push(fileContent.slice(i * chunkSize));
+      } else {
+        fileChunks.push(fileContent.slice(i * chunkSize, (i + 1) * chunkSize));
+      }
+    }
+
+    return {
+      bytes: fileChunks, //split it into 8MB chunks
+      path: path.basename(filePath),
+      type,
+      numberChunks
+    };
+  });
+
+  for (let i = 0; i < dataList.length; i++) {
+    const { bytes, path, type, numberChunks } = dataList[i];
+    for (let j = 0; j < bytes.length; j++) {
+      const file: File = {
+        bytes: bytes[j],
+        path,
+        type,
+        numberChunks,
+        chunkNumber: j,
+        fileNumber: i
+      };
+      await driver.executeScript(
+        (file: File, filestoreName: string, filenamePrefix: string) => {
+          // create the filestore object if not already exists
+          const filestore = ((window as WebDriverWindow)[filestoreName] =
+            (window as WebDriverWindow)[filestoreName] || {});
+          const chunkNumber = file.chunkNumber;
+          const data = {
+            bytes: file.bytes,
+            path: file.path,
+            type: file.type
+          };
+          const fileKey = filenamePrefix + file.fileNumber;
+          if (chunkNumber == 0) {
+            filestore[fileKey] = [data];
+          } else {
+            filestore[fileKey].push(data);
+          }
+        },
+        file,
+        filestoreName,
+        filenamePrefix
+      );
+    }
+  }
+
+  driver.executeScript(
+    (numFiles: number, filestoreName: string, filenamePrefix: string) => {
+      const filestore = (window as WebDriverWindow)[filestoreName];
+      const list: FileData[] = [];
+      for (let i = 0; i < numFiles; i++) {
+        const fileKey = filenamePrefix + i;
+        const chunks: File[] = filestore[fileKey];
+        delete filestore[fileKey];
+        list.push({
+          bytes: chunks.reduce<number[]>((acc, chunk) => acc.concat(chunk.bytes), []),
+          path: chunks[0].path,
+          type: chunks[0].type
+        });
+      }
+      const fileList = list.map((data) => {
+        return new File([Uint8Array.from(data.bytes)], data.path, { type: data.type });
+      });
+      // Only if setupPickFiles has not been called yet
+      if (!(HTMLInputElement as any).prototype._pickerTestData) {
+        //Save the native click method
+        const clickMethod = HTMLInputElement.prototype.click;
+        //Overwrite the click method
+        HTMLInputElement.prototype.click = function () {
+          const event = new CustomEvent('change');
+          this.dispatchEvent(event);
+          delete (HTMLInputElement as any).prototype._pickerTestData;
+          HTMLInputElement.prototype.click = clickMethod;
+        };
+      }
+      (HTMLInputElement as any).prototype._pickerTestData = fileList;
+    },
+    dataList.length,
+    filestoreName,
+    filenamePrefix
+  );
+};
+
+/**
+ * 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 const doSelect = async (
+  picker: WebElement,
+  files: Array<{ path: string; type: string }>
+) => {
+  const driver = picker.getDriver();
+  await setupPickFiles(driver, files);
+  await driver.executeScript((el: any) => el.firstChild.click(), picker);
+  return whenBusyContextReady(driver);
+};

package/{lib → src/lib}/input-utils.ts

@@ -58,18 +58,12 @@ export function mixinChangeValue(clazz: typeof OjWebElement) {
       }
       await input.sendKeys(value);
 
-      return driver.executeAsyncScript(
-        `
-        let el = arguments[0];
-        let done = arguments[1];
+      return driver.executeScript((el: any) => {
         if (typeof el.validate === 'function') {
-          el.validate().then(done).catch(done);
-        } else {
-          done();
+          return el.validate();
         }
-      `,
-        this
-      );
+        return Promise.resolve();
+      }, this);
     },
     writable: true
   });