@oracle/oraclejet-webdriver 10.0.8

package/lib/driver-override.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = void 0;
+const selenium_webdriver_1 = require("selenium-webdriver");
+const OjWebElement_1 = require("../elements/OjWebElement");
+const stale_element_1 = require("./stale-element");
+function register(tagName, ctor) {
+    WebElementRegistry.register(tagName, ctor);
+}
+exports.register = register;
+class WebElementRegistry {
+    static register(tagName, ctor) {
+        WebElementRegistry.tagToCtorMap[tagName] = ctor;
+    }
+    static get(tagName) {
+        return WebElementRegistry.tagToCtorMap[tagName];
+    }
+}
+WebElementRegistry.tagToCtorMap = {};
+selenium_webdriver_1.WebDriver.prototype.findElement = wrapFindElement(selenium_webdriver_1.WebDriver.prototype.findElement);
+selenium_webdriver_1.WebDriver.prototype.findElements = wrapFindElements(selenium_webdriver_1.WebDriver.prototype.findElements);
+selenium_webdriver_1.WebElement.prototype.findElement = wrapFindElement(selenium_webdriver_1.WebElement.prototype.findElement);
+selenium_webdriver_1.WebElement.prototype.findElements = wrapFindElements(selenium_webdriver_1.WebElement.prototype.findElements);
+selenium_webdriver_1.WebDriver.prototype.wait = wrapWait(selenium_webdriver_1.WebDriver.prototype.wait);
+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);
+function wrapFindElement(origFunc) {
+    return function findElement(locator) {
+        const elPromise = origFunc.call(this, locator);
+        const parentEl = this instanceof selenium_webdriver_1.WebElement ? this : undefined;
+        return new selenium_webdriver_1.WebElementPromise(elPromise.getDriver(), elPromise.then((el) => createTestAdapter(el, locator, parentEl)));
+    };
+}
+function wrapFindElements(origFunc) {
+    return async function findElements(locator) {
+        const elRef = this instanceof selenium_webdriver_1.WebElement ? this : undefined;
+        const matches = await origFunc.call(this, locator);
+        const weMatches = [];
+        for (let el, i = 0, len = matches.length; i < len; i++) {
+            el = matches[i];
+            const ce = await createTestAdapter(el, locator, elRef, i);
+            weMatches.push(ce);
+        }
+        return weMatches;
+    };
+}
+function wrapWait(origFunc) {
+    return function wait(condition, optTimeout, optMessage) {
+        return origFunc
+            .call(this, condition, optTimeout, optMessage)
+            .then((p) => {
+            if (p instanceof selenium_webdriver_1.WebElement) {
+                return createTestAdapter(p);
+            }
+            return p;
+        });
+    };
+}
+function wrapExecuteScript(origFunc) {
+    return async function (...args) {
+        var _a;
+        try {
+            const ret = await origFunc.apply(this, args);
+            return ret;
+        }
+        catch (ex) {
+            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];
+                    if (arg instanceof OjWebElement_1.OjWebElement) {
+                        arg = await stale_element_1.requeryElement(arg);
+                        locators.push((_a = arg._locators) === null || _a === void 0 ? void 0 : _a.elLocator);
+                    }
+                    newArgs.push(arg);
+                }
+                console.warn(`Trapped stale element executing script on ${locators}`);
+                return origFunc.apply(this, newArgs);
+            }
+            throw ex;
+        }
+    };
+}
+async function createTestAdapter(el, elLocator, parentEl, elementsIndex) {
+    const tagName = await getTagName(el, elLocator, parentEl, elementsIndex);
+    const ctor = WebElementRegistry.get(tagName) || OjWebElement_1.OjWebElement;
+    return new ctor(el, {
+        elLocator,
+        elementsIndex,
+        parentEl,
+        tagName,
+    });
+}
+async function getTagName(el, elLocator, parentEl, elementsIndex) {
+    let tagName;
+    try {
+        tagName = await el.getTagName();
+    }
+    catch (ex) {
+        if (ex instanceof selenium_webdriver_1.error.StaleElementReferenceError && elLocator) {
+            const driver = parentEl || el.getDriver();
+            let requeried;
+            if (elementsIndex === undefined) {
+                requeried = await driver.findElement(elLocator);
+            }
+            else {
+                const matches = await driver.findElements(elLocator);
+                requeried = matches[elementsIndex];
+            }
+            tagName = await getTagName(requeried, elLocator, parentEl, elementsIndex);
+        }
+    }
+    return tagName;
+}
+//# sourceMappingURL=driver-override.js.map

package/lib/driver-override.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-override.js","sourceRoot":"","sources":["../../../rt/src/test/webdriverjs/oraclejet-webdriver/lib/driver-override.ts"],"names":[],"mappings":"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"}

package/lib/driver-override.ts

@@ -0,0 +1,270 @@
+import {
+  error,
+  Locator,
+  WebDriver,
+  WebElement,
+  WebElementCondition,
+  WebElementPromise,
+} from "selenium-webdriver";
+
+// Import OjWebElement directly from its file rather than through
+// 'elements' package, to avoid circular dependency (elements will
+// call to register themselves upon loading)
+import { OjWebElement, ElementLocators } from "../elements/OjWebElement";
+import { requeryElement } from "./stale-element";
+
+/**
+ * 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 function register(
+  tagName: string,
+  ctor: new (el: WebElement, locators: ElementLocators) => OjWebElement
+) {
+  WebElementRegistry.register(tagName, ctor);
+}
+
+/**
+ * A registry which associates the constructors for custom WebElements with their
+ * associated tag names. This registry should only be used internally by custom
+ * WebElement implementations, and shouldn't be used directly in tests.
+ */
+class WebElementRegistry {
+  /**
+   * 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
+   */
+  public static register(
+    tagName: string,
+    ctor: new (el: WebElement, locators: ElementLocators) => OjWebElement
+  ) {
+    WebElementRegistry.tagToCtorMap[tagName] = ctor;
+  }
+  /**
+   * Get the constructor for a custom WebElement given a tag name.
+   * @param tagName The DOM tag name for the custom element
+   * @return A custom WebElement constructor for the given tagName, or undefined
+   * if none exists.
+   */
+  public static get(
+    tagName: string
+  ): new (el: WebElement, locators: ElementLocators) => OjWebElement {
+    return WebElementRegistry.tagToCtorMap[tagName];
+  }
+  /**
+   * A mapping of element tag names to WebElement constructors
+   */
+  private static tagToCtorMap: {
+    [tagName: string]: new (
+      el: WebElement,
+      locators: ElementLocators
+    ) => OjWebElement;
+  } = {};
+}
+
+WebDriver.prototype.findElement = wrapFindElement(
+  WebDriver.prototype.findElement
+);
+WebDriver.prototype.findElements = wrapFindElements(
+  WebDriver.prototype.findElements
+);
+
+WebElement.prototype.findElement = wrapFindElement(
+  WebElement.prototype.findElement
+);
+WebElement.prototype.findElements = wrapFindElements(
+  WebElement.prototype.findElements
+);
+
+WebDriver.prototype.wait = wrapWait(WebDriver.prototype.wait);
+
+WebDriver.prototype.executeScript = wrapExecuteScript(
+  WebDriver.prototype.executeScript
+);
+WebDriver.prototype.executeAsyncScript = wrapExecuteScript(
+  WebDriver.prototype.executeAsyncScript
+);
+
+/**
+ * Create a wrapper for findElement()
+ * @param origFunc The original findElement function
+ */
+function wrapFindElement(origFunc: (locator: Locator) => WebElementPromise) {
+  return function findElement(locator: Locator): WebElementPromise {
+    const elPromise = origFunc.call(this, locator);
+    // Pass ourselves as parent if this is WebElement.findElement
+    const parentEl = this instanceof WebElement ? this : undefined;
+    return new WebElementPromise(
+      elPromise.getDriver(),
+      elPromise.then((el: WebElement) =>
+        createTestAdapter(el, locator, parentEl)
+      )
+    );
+  };
+}
+/**
+ * Create a wrapper for findElements()
+ * @param origFunc The original findElements function
+ */
+function wrapFindElements(
+  origFunc: (locator: Locator) => Promise<WebElement[]>
+) {
+  return async function findElements(locator: Locator): Promise<WebElement[]> {
+    // Pass ourselves as parent if this is WebElement.findElements
+    const elRef = this instanceof WebElement ? this : undefined;
+    const matches = await origFunc.call(this, locator);
+    const weMatches: WebElement[] = [];
+    for (let el, i = 0, len = matches.length; i < len; i++) {
+      el = matches[i];
+      const ce = await createTestAdapter(el, locator, elRef, i);
+      weMatches.push(ce);
+    }
+    return weMatches;
+  };
+}
+/**
+ * Create a wrapper for driver.wait() which returns an OjWebElementPromise. Although
+ * WebDriver.wait returns WebElementPromise, we need to wrap into a function that
+ * returns "any" because createCustomElement returns Promise<WebElement>, and the
+ * two types aren't compatible.
+ * @param origFunc The driver.wait function
+ */
+function wrapWait(
+  origFunc: (
+    condition: WebElementCondition,
+    optTimeout?: number,
+    optMessage?: string
+  ) => WebElementPromise
+) {
+  return function wait(
+    condition: WebElementCondition,
+    optTimeout?: number,
+    optMessage?: string
+  ): WebElementPromise {
+    return origFunc
+      .call(this, condition, optTimeout, optMessage)
+      .then((p: WebElement) => {
+        if (p instanceof WebElement) {
+          // Note: wait(until.elementLocated) doesn't provide access to original
+          // element locator needed by createTestAdapter to requery the element if
+          // a StaleElement error occurs
+          return createTestAdapter(p);
+        }
+        return p;
+      });
+  };
+}
+
+/**
+ * Wrap WebDriver.executeScript/executeAsyncScript with a function that traps
+ * StaleElementReferenceError and requeries the element(s) to try again
+ * @param origFunc The original driver.executeScript/executeAsyncScript
+ */
+function wrapExecuteScript(origFunc: <T>(...args: any) => Promise<T>) {
+  return async function<T>(...args: any[]): Promise<T> {
+    try {
+      const ret: T = await origFunc.apply(this, args);
+      return ret;
+    } catch (ex) {
+      if (ex instanceof error.StaleElementReferenceError) {
+        const newArgs = [];
+        const locators = [];
+        for (let i = 0, len = args.length; i < len; i++) {
+          let arg = args[i];
+          // Requery arguments which are OjWebElements
+          if (arg instanceof OjWebElement) {
+            arg = await requeryElement(arg);
+            locators.push(arg._locators?.elLocator);
+          }
+          newArgs.push(arg);
+        }
+        console.warn(
+          `Trapped stale element executing script on ${locators}`
+        );
+        return origFunc.apply(this, newArgs);
+      }
+      throw ex;
+    }
+  };
+}
+
+/**
+ * Create a custom WebElement from the original one. The WebElement constructor
+ * is looked up in WebElementRegistry using the element's tag name, and the
+ * registry is populated by each custom element. If no constructor is found,
+ * OjWebElement is used.
+ * @param el The original WebElement
+ * @param elLocator The By locator used to originally locate the element. This
+ * locator will be used to re-query the element for its tagName if stale element
+ * exception is encountered. If not supplied, this function will return OjWebElement
+ * @param parentEl The immediate parent from which we were queried (WebElement.findElement)
+ * @param elementsIndex The index within the array of WebElements returned from
+ * findElements.
+ * detected.
+ * @return {OjWebElement} The test adapter for the given element, or OjWebElement
+ * if none exists
+ */
+async function createTestAdapter(
+  el: WebElement,
+  elLocator?: Locator,
+  parentEl?: OjWebElement,
+  elementsIndex?: number
+): Promise<WebElement> {
+  // Call exception-trapping getTagName() to ensure any exceptions are caught,
+  // and the call returns.
+  const tagName = await getTagName(el, elLocator, parentEl, elementsIndex);
+  const ctor = WebElementRegistry.get(tagName) || OjWebElement;
+  return new ctor(el, {
+    elLocator,
+    elementsIndex,
+    parentEl,
+    tagName,
+  });
+}
+
+/**
+ * Query the for element's tag name. This function traps StaleElement exceptions
+ * and requeries the element to try the call again. All other exceptions are
+ * caught and an empty tagName will be returned.
+ * @param el The original element
+ * @param elLocator The element Locator
+ * @param parentEl A parent element which contains the element, if any
+ * @param elementsIndex An index in the array of matched items for the original
+ * element
+ * @return {string} The element's tag name
+ */
+async function getTagName(
+  el: WebElement,
+  elLocator?: Locator,
+  parentEl?: OjWebElement,
+  elementsIndex?: number
+): Promise<string> {
+  let tagName: string;
+  try {
+    tagName = await el.getTagName();
+  } catch (ex) {
+    // Only try to requery on stale element exception if original elLocator
+    // exists. The locator is present most of the time, except if the element
+    // was returned from driver.wait(until.elementLocated). That method doesn't
+    // provide access to the original locator.
+    if (ex instanceof error.StaleElementReferenceError && elLocator) {
+      const driver = parentEl || el.getDriver();
+      let requeried: WebElement;
+
+      if (elementsIndex === undefined) {
+        // Element found with findElement (single)
+        requeried = await driver.findElement(elLocator);
+      } else {
+        // Element found with findElements (multiple)
+        const matches = await driver.findElements(elLocator);
+        requeried = matches[elementsIndex];
+      }
+      // Call exception-trapping getTagName() again, just in case another exception
+      // occurs with calling element.getTagName() on the new re-queried element.
+      tagName = await getTagName(requeried, elLocator, parentEl, elementsIndex);
+    }
+  }
+  return tagName;
+}

package/lib/input-utils.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mixinChangeValue = void 0;
+const selenium_webdriver_1 = require("selenium-webdriver");
+function mixinChangeValue(clazz) {
+    Object.defineProperty(clazz.prototype, "changeValue", {
+        value: async function (value) {
+            const input = await this.findElement(selenium_webdriver_1.By.css('.oj-text-field-input'));
+            await input.clear();
+            await input.sendKeys(value);
+            return this.getDriver().executeAsyncScript(`
+        let el = arguments[0];
+        let done = arguments[1];
+        if (typeof el.validate === 'function') {
+          el.validate().then(done).catch(done);
+        } else {
+          done();
+        }
+      `, this);
+        },
+    });
+}
+exports.mixinChangeValue = mixinChangeValue;
+//# sourceMappingURL=input-utils.js.map

package/lib/input-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-utils.js","sourceRoot":"","sources":["../../../rt/src/test/webdriverjs/oraclejet-webdriver/lib/input-utils.ts"],"names":[],"mappings":";;;AAIA,2DAAwC;AA0BxC,SAAgB,gBAAgB,CAAC,KAA0B;IACzD,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,aAAa,EAAE;QACpD,KAAK,EAAE,KAAK,WAAW,KAAa;YAElC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,uBAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC;YACrE,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;YAEpB,MAAM,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,kBAAkB,CAAC;;;;;;;;OAQ1C,EAAE,IAAI,CAAC,CAAC;QACX,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAnBD,4CAmBC"}

package/lib/input-utils.ts

@@ -0,0 +1,50 @@
+/*
+ * Set of utilities common to input component test adapters
+ */
+
+import { By } from "selenium-webdriver";
+import { OjWebElement } from "../elements";
+
+/**
+ * This method should only be called by test adapter classes for input components
+ * which support text input, such as oj-input-text, oj-input-date, etc.
+ * Mixin a "changeValue" function to the given class to perform a value change
+ * on the component.
+ *
+ * NOTE: The changeValue method will focus on the component's .oj-text-field-input
+ * and call sendKeys to send the value through the component UI. To trigger the
+ * value update and validation, this method also calls validate() on the component
+ * directly.
+ * We don't want to send Tab because that can cause other model updates in the
+ * component is embedded within another container which is listening on blur to
+ * update its values, such as oj-dynamic-form.
+ * We also don't want to send Enter as that can cause containers listening on
+ * key events to submit/navigate/etc when Enter is received on any of the fields,
+ * such as a field in oj-dialog which closes the dialog when user presses Enter.
+ *
+ * @param clazz The class to be modified
+ * @param inputLocator An optional Locator which identifies the input element to
+ * be interacted with. This locator should be relative to the component root, and
+ * should be able to receive focus in the DOM. If not specified, the root of the
+ * component is assumed to be the focusable element.
+ */
+export function mixinChangeValue(clazz: typeof OjWebElement) {
+  Object.defineProperty(clazz.prototype, "changeValue", {
+    value: async function (value: string) {
+      // Find <input> to clear
+      const input = await this.findElement(By.css('.oj-text-field-input'));
+      await input.clear();
+      // Send the value with sendKeys, then call validate()
+      await input.sendKeys(value);
+      return this.getDriver().executeAsyncScript(`
+        let el = arguments[0];
+        let done = arguments[1];
+        if (typeof el.validate === 'function') {
+          el.validate().then(done).catch(done);
+        } else {
+          done();
+        }
+      `, this);
+    },
+  });
+}

package/lib/slot-proxy.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slotProxy = void 0;
+function slotProxy(el) {
+    if (!el) {
+        throw Error('No root element given for SlotProxy');
+    }
+    return new SlotProxyImpl(el);
+}
+exports.slotProxy = slotProxy;
+class SlotProxyImpl {
+    constructor(el) {
+        this._root = el;
+    }
+    getDriver() {
+        return this._root.getDriver();
+    }
+    findElement(locator) {
+        return this._root.findElement(locator);
+    }
+    findElements(locator) {
+        return this._root.findElements(locator);
+    }
+}
+//# sourceMappingURL=slot-proxy.js.map

package/lib/slot-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-proxy.js","sourceRoot":"","sources":["../../../rt/src/test/webdriverjs/oraclejet-webdriver/lib/slot-proxy.ts"],"names":[],"mappings":";;;AA+BA,SAAgB,SAAS,CAAC,EAAc;IACtC,IAAI,CAAC,EAAE,EAAE;QACP,MAAM,KAAK,CAAC,qCAAqC,CAAC,CAAC;KACpD;IACD,OAAO,IAAI,aAAa,CAAC,EAAE,CAAC,CAAC;AAC/B,CAAC;AALD,8BAKC;AAMD,MAAM,aAAa;IAGjB,YAAY,EAAc;QACxB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;IAChC,CAAC;IAED,WAAW,CAAC,OAAgB;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,YAAY,CAAC,OAAgB;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/lib/slot-proxy.ts

@@ -0,0 +1,61 @@
+import {
+  WebElement,
+  Locator,
+  WebElementPromise,
+  WebDriver
+} from "selenium-webdriver";
+
+/**
+ * A proxy to the underlying WebElement which represents a slot/single row within
+ * the component.
+ */
+export interface SlotProxy {
+  /**
+   * Find a WebElement within this SlotProxy
+   * @param locator The element locator
+   */
+  findElement(locator: Locator): WebElementPromise;
+  /**
+   * Find an array of matching elements within this SlotProxy
+   * @param locator The elements locator
+   */
+  findElements(locator: Locator): Promise<WebElement[]>;
+}
+
+
+/**
+ * Create a SlotProxy proxy for the given WebElement
+ * @param el The WebElement to proxy
+ * @return {SlotProxy} A SlotProxy implementation which wraps the given
+ * WebElement.
+ */
+export function slotProxy(el: WebElement): SlotProxy {
+  if (!el) {
+    throw Error('No root element given for SlotProxy');
+  }
+  return new SlotProxyImpl(el);
+}
+
+/*
+ * Default implementation of SlotProxy, used to wrap the underlying WebElement
+ * for the collection row and delegate exposed functionality to that WebElement.
+ */
+class SlotProxyImpl implements SlotProxy {
+  private _root: WebElement;
+
+  constructor(el: WebElement) {
+    this._root = el;
+  }
+
+  getDriver(): WebDriver {
+    return this._root.getDriver();
+  }
+
+  findElement(locator: Locator): WebElementPromise {
+    return this._root.findElement(locator);
+  }
+
+  findElements(locator: Locator): Promise<WebElement[]> {
+    return this._root.findElements(locator);
+  }
+}

package/lib/stale-element.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requeryElement = void 0;
+async function requeryElement(el) {
+    const driver = el.getDriver();
+    const locators = el._locators || {};
+    let requeried;
+    const parentEl = locators.parentEl
+        ? await requeryElement(locators.parentEl)
+        : driver;
+    if (locators.elementsIndex === undefined) {
+        requeried = (await parentEl.findElement(locators.elLocator));
+    }
+    else {
+        const elements = await parentEl.findElements(locators.elLocator);
+        requeried = elements[locators.elementsIndex];
+    }
+    const reTagName = await requeried.getTagName();
+    if (el.constructor !== requeried.constructor ||
+        locators.tagName !== reTagName) {
+        throw Error(`Expected to find <${locators.tagName}> but got <${reTagName}>`);
+    }
+    return requeried;
+}
+exports.requeryElement = requeryElement;
+//# sourceMappingURL=stale-element.js.map

package/lib/stale-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-element.js","sourceRoot":"","sources":["../../../rt/src/test/webdriverjs/oraclejet-webdriver/lib/stale-element.ts"],"names":[],"mappings":";;;AAQO,KAAK,UAAU,cAAc,CAClC,EAAK;IAEL,MAAM,MAAM,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAI,EAAU,CAAC,SAAS,IAAI,EAAE,CAAC;IAC7C,IAAI,SAAY,CAAC;IAGjB,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ;QAChC,CAAC,CAAC,MAAM,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACzC,CAAC,CAAC,MAAM,CAAC;IAEX,IAAI,QAAQ,CAAC,aAAa,KAAK,SAAS,EAAE;QAExC,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAM,CAAC;KACnE;SAAM;QAEL,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACjE,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAM,CAAC;KACnD;IACD,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,UAAU,EAAE,CAAC;IAE/C,IACE,EAAE,CAAC,WAAW,KAAK,SAAS,CAAC,WAAW;QACxC,QAAQ,CAAC,OAAO,KAAK,SAAS,EAC9B;QACA,MAAM,KAAK,CACT,qBAAqB,QAAQ,CAAC,OAAO,cAAc,SAAS,GAAG,CAChE,CAAC;KACH;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AA/BD,wCA+BC"}

package/lib/stale-element.ts

@@ -0,0 +1,40 @@
+import { OjWebElement } from "../elements";
+
+/**
+ * Requery the WebElement using its stored locator
+ * @private
+ * @param el The WebElement to requery
+ * @return A Promise with the re-queried WebElement
+ */
+export async function requeryElement<T extends OjWebElement>(
+  el: T
+): Promise<T> {
+  const driver = el.getDriver();
+  const locators = (el as any)._locators || {};
+  let requeried: T;
+
+  // If parentEl exists, find it first before locating element
+  const parentEl = locators.parentEl
+    ? await requeryElement(locators.parentEl)
+    : driver;
+
+  if (locators.elementsIndex === undefined) {
+    // Element found with findElement (single)
+    requeried = (await parentEl.findElement(locators.elLocator)) as T;
+  } else {
+    // Element found with findElements (multiple)
+    const elements = await parentEl.findElements(locators.elLocator);
+    requeried = elements[locators.elementsIndex] as T;
+  }
+  const reTagName = await requeried.getTagName();
+  // Check that the requeried element is of the same type as the original.
+  if (
+    el.constructor !== requeried.constructor ||
+    locators.tagName !== reTagName
+  ) {
+    throw Error(
+      `Expected to find <${locators.tagName}> but got <${reTagName}>`
+    );
+  }
+  return requeried;
+}

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@oracle/oraclejet-webdriver",
+  "version": "10.0.8",
+  "description": "Oracle JET WebDriverJS WebElements",
+  "config": {
+    "revision": "2022-05-03_19-22-22"
+  },
+  "dependencies": {},
+  "devDependencies": {},
+  "files": [
+    "index.*",
+    "tsconfig.json",
+    "/elements/**/*",
+    "/lib/**/*",
+    "/bin/**/*"
+  ],
+  "scripts": {
+  }
+}

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../tsconfig",
+  "compilerOptions": {
+    "rootDir": "."
+  },
+  "include": [
+    "index.ts",
+    "elements/**/*.ts"
+  ]
+}