From 0d582b1401642f80e1c086a177b9dcbc89ea7189 Mon Sep 17 00:00:00 2001 From: labkey-tchad Date: Wed, 25 Feb 2026 08:53:18 -0800 Subject: [PATCH 1/4] Update Selenium version to 4.41.0 --- gradle.properties | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gradle.properties b/gradle.properties index de493ea18a..c1d3217e49 100644 --- a/gradle.properties +++ b/gradle.properties @@ -10,7 +10,7 @@ lookfirstSardineVersion=5.13 jettyVersion=12.1.5 -seleniumVersion=4.40.0 +seleniumVersion=4.41.0 mockserverNettyVersion=5.15.0 From d74c02bffda195f4c84b2ff84a955143d21ac3af Mon Sep 17 00:00:00 2001 From: labkey-tchad Date: Wed, 25 Feb 2026 12:52:16 -0800 Subject: [PATCH 2/4] Centralize JavaScriptExecutor --- src/org/labkey/test/WebDriverWrapper.java | 19 +---- .../selenium/JavascriptExecutorWrapper.java | 85 +++++++++++++++++++ .../test/util/selenium/WebDriverUtils.java | 13 +++ .../test/util/selenium/WebElementUtils.java | 29 ++++++- 4 files changed, 130 insertions(+), 16 deletions(-) create mode 100644 src/org/labkey/test/util/selenium/JavascriptExecutorWrapper.java diff --git a/src/org/labkey/test/WebDriverWrapper.java b/src/org/labkey/test/WebDriverWrapper.java index 4065e31c28..af3e2b6a67 100644 --- a/src/org/labkey/test/WebDriverWrapper.java +++ b/src/org/labkey/test/WebDriverWrapper.java @@ -63,6 +63,7 @@ import org.labkey.test.util.TextSearcher; import org.labkey.test.util.TextSearcher.TextTransformers; import org.labkey.test.util.Timer; +import org.labkey.test.util.selenium.JavascriptExecutorWrapper; import org.labkey.test.util.selenium.ScrollUtils; import org.labkey.test.util.selenium.WebDriverUtils; import org.openqa.selenium.Alert; @@ -539,11 +540,7 @@ public Object executeScript(@Language("JavaScript") String script, Object... arg */ public T executeScript(@Language("JavaScript") String script, Class expectedResultType, Object... arguments) { - Object o = executeScript(script, arguments); - if (o != null && !expectedResultType.isAssignableFrom(o.getClass())) - Assert.fail("Script return wrong type. Expected '" + expectedResultType.getSimpleName() + "'. Got: " + o.getClass().getName() + ". Result: " + o); - - return (T) o; + return new JavascriptExecutorWrapper(getDriver()).executeScript(script, expectedResultType, arguments); } /** @@ -552,20 +549,12 @@ public T executeScript(@Language("JavaScript") String script, Class expec */ public Object executeAsyncScript(@Language("JavaScript") String script, Object... arguments) { - script = "var callback = arguments[arguments.length - 1];\n" + // See WebDriver documentation for details on injected callback - "try {" + - script + - "} catch (error) { callback(error); }"; // ensure that the callback is invoked when an exception would otherwise prevent it - return ((JavascriptExecutor) getDriver()).executeAsyncScript(script, arguments); + return new JavascriptExecutorWrapper(getDriver()).executeAsyncScript(script, arguments); } public T executeAsyncScript(@Language("JavaScript") String script, Class expectedResultType, Object... arguments) { - Object o = executeAsyncScript(script, arguments); - if (o != null && !expectedResultType.isAssignableFrom(o.getClass())) - Assert.fail("Script return wrong type. Expected '" + expectedResultType.getSimpleName() + "'. Got: " + o.getClass().getName() + ". Result: " + o); - - return (T) o; + return new JavascriptExecutorWrapper(getDriver()).executeAsyncScript(script, expectedResultType, arguments); } @LogMethod(quiet = true) diff --git a/src/org/labkey/test/util/selenium/JavascriptExecutorWrapper.java b/src/org/labkey/test/util/selenium/JavascriptExecutorWrapper.java new file mode 100644 index 0000000000..f894b6fba4 --- /dev/null +++ b/src/org/labkey/test/util/selenium/JavascriptExecutorWrapper.java @@ -0,0 +1,85 @@ +package org.labkey.test.util.selenium; + +import org.intellij.lang.annotations.Language; +import org.jetbrains.annotations.Nullable; +import org.openqa.selenium.JavascriptExecutor; +import org.openqa.selenium.ScriptKey; +import org.openqa.selenium.WebDriver; + +import java.util.Set; + +public class JavascriptExecutorWrapper implements JavascriptExecutor +{ + final JavascriptExecutor _executor; + + public JavascriptExecutorWrapper(WebDriver driver) + { + _executor = (JavascriptExecutor) driver; + } + + @Override + public @Nullable Object executeScript(@Language("JavaScript") String script, @Nullable Object... args) + { + return _executor.executeScript(script, args); + } + + @Override + public @Nullable Object executeScript(ScriptKey key, @Nullable Object... args) + { + return _executor.executeScript(key, args); + } + + /** + * Wrapper for executing JavaScript through WebDriver and verifying return type. + * @param See {@link JavascriptExecutor#executeScript(java.lang.String, java.lang.Object...)} for valid return types + */ + public @Nullable T executeScript(@Language("JavaScript") String script, Class expectedResultType, @Nullable Object... arguments) + { + return verifyType(expectedResultType, executeScript(script, arguments)); + } + + /** + * Wrapper for synchronous execution of asynchronous JavaScript. This wrapper extracts the 'callback' from the argument list + * See {@link JavascriptExecutor#executeAsyncScript(java.lang.String, java.lang.Object...)} for details + */ + @Override + public @Nullable Object executeAsyncScript(@Language("JavaScript") String script, @Nullable Object... arguments) + { + script = "var callback = arguments[arguments.length - 1];\n" + // See WebDriver documentation for details on injected callback + "try {" + + script + + "} catch (error) { callback(error); }"; // ensure that the callback is invoked when an exception would otherwise prevent it + return _executor.executeAsyncScript(script, arguments); + } + + public @Nullable T executeAsyncScript(@Language("JavaScript") String script, Class expectedResultType, @Nullable Object... arguments) + { + return verifyType(expectedResultType, executeAsyncScript(script, arguments)); + } + + private @Nullable T verifyType(Class expectedResultType, @Nullable Object o) + { + if (o != null && !expectedResultType.isAssignableFrom(o.getClass())) + throw new IllegalStateException("Script return wrong type. Expected '" + expectedResultType.getName() + "'. Got: " + o.getClass().getName() + ". Result: " + o); + + return (T) o; + } + + @Override + public Set getPinnedScripts() + { + return _executor.getPinnedScripts(); + } + + @Override + public void unpin(ScriptKey key) + { + _executor.unpin(key); + } + + @Override + public ScriptKey pin(@Language("JavaScript") String script) + { + return _executor.pin(script); + } +} diff --git a/src/org/labkey/test/util/selenium/WebDriverUtils.java b/src/org/labkey/test/util/selenium/WebDriverUtils.java index eff8ec79bc..3e6b78dd41 100644 --- a/src/org/labkey/test/util/selenium/WebDriverUtils.java +++ b/src/org/labkey/test/util/selenium/WebDriverUtils.java @@ -25,6 +25,8 @@ import org.openqa.selenium.WrapsDriver; import org.openqa.selenium.WrapsElement; +import java.util.Objects; + public abstract class WebDriverUtils { /** @@ -74,6 +76,17 @@ public static WebDriver extractWrappedDriver(Object peeling) return null; } + /** + * Extract a WebDriver instance from an arbitrarily wrapped object and the JavascriptExecutor tied to it. + * + * @param object Object that wraps a WebDriver. Typically, a Component, SearchContext, or WebElement + * @return JavascriptExecutor instance + */ + public static JavascriptExecutorWrapper getJavascriptExecutor(Object object) + { + return Objects.requireNonNull(new JavascriptExecutorWrapper(extractWrappedDriver(object)), () -> "No WebDriver found in " + object.getClass()); + } + /** * Attempts to get alert text from an {@link UnhandledAlertException}. If exception does not supply the alert text, * attempt to get it from the alert directly (requires {@link org.openqa.selenium.UnexpectedAlertBehaviour#IGNORE}). diff --git a/src/org/labkey/test/util/selenium/WebElementUtils.java b/src/org/labkey/test/util/selenium/WebElementUtils.java index d6866f73de..5f7c823561 100644 --- a/src/org/labkey/test/util/selenium/WebElementUtils.java +++ b/src/org/labkey/test/util/selenium/WebElementUtils.java @@ -1,13 +1,17 @@ package org.labkey.test.util.selenium; import org.intellij.lang.annotations.Language; +import org.labkey.test.selenium.LazyWebElement; import org.openqa.selenium.JavascriptExecutor; import org.openqa.selenium.NoSuchElementException; +import org.openqa.selenium.StaleElementReferenceException; import org.openqa.selenium.WebDriverException; import org.openqa.selenium.WebElement; import java.util.Collections; import java.util.List; +import java.util.Objects; +import java.util.Optional; import static org.labkey.test.Locator.NBSP; @@ -93,6 +97,29 @@ public static String getTextNodeWithin(WebElement element) */ public static String getTextContent(WebElement element) { - return element.getDomProperty("textContent").replace(NBSP, " "); + return Optional.ofNullable(element.getDomProperty("textContent")).map(s -> s.replace(NBSP, " ")).orElse(null); + } + + /** + * Determines whether the specified element is visible. {@link WebElement#isDisplayed()} might return false if the + * element is out the viewport and scrolling is disabled due to a modal dialog.
+ * TODO: Consider moving to {@link LazyWebElement#isDisplayed()} + * + * @param element element to inspect + * @return true if the element is visible, false otherwise + */ + public static boolean checkVisibility(WebElement element) + { + try + { + return element.isDisplayed() || + Objects.requireNonNullElse(WebDriverUtils.getJavascriptExecutor(element) + .executeScript("return arguments[0].checkVisibility();", Boolean.class, element), + false); + } + catch (NoSuchElementException | StaleElementReferenceException e) + { + return false; + } } } From d125fb552eb231a916333935334d945591d727a1 Mon Sep 17 00:00:00 2001 From: labkey-tchad Date: Wed, 25 Feb 2026 12:52:25 -0800 Subject: [PATCH 3/4] Add workaround for issue with isDisplayed --- src/org/labkey/test/components/ui/grids/ResponsiveGrid.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/org/labkey/test/components/ui/grids/ResponsiveGrid.java b/src/org/labkey/test/components/ui/grids/ResponsiveGrid.java index 625e9d4909..f21859cec3 100644 --- a/src/org/labkey/test/components/ui/grids/ResponsiveGrid.java +++ b/src/org/labkey/test/components/ui/grids/ResponsiveGrid.java @@ -75,7 +75,7 @@ public WebElement getComponentElement() public Boolean isLoaded() { - return getComponentElement().isDisplayed() && + return WebElementUtils.checkVisibility(getComponentElement()) && !Locators.loadingGrid.existsIn(this) && !Locators.spinner.existsIn(this) && (Locator.tag("td").existsIn(this) || From af4a9b829d1c1bd8685655685159c9c296297b85 Mon Sep 17 00:00:00 2001 From: labkey-tchad Date: Wed, 25 Feb 2026 13:08:03 -0800 Subject: [PATCH 4/4] Better name --- .../util/selenium/JavascriptExecutorWrapper.java | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/src/org/labkey/test/util/selenium/JavascriptExecutorWrapper.java b/src/org/labkey/test/util/selenium/JavascriptExecutorWrapper.java index f894b6fba4..ceb3928b8a 100644 --- a/src/org/labkey/test/util/selenium/JavascriptExecutorWrapper.java +++ b/src/org/labkey/test/util/selenium/JavascriptExecutorWrapper.java @@ -10,23 +10,23 @@ public class JavascriptExecutorWrapper implements JavascriptExecutor { - final JavascriptExecutor _executor; + private final JavascriptExecutor _wrappedExecutor; public JavascriptExecutorWrapper(WebDriver driver) { - _executor = (JavascriptExecutor) driver; + _wrappedExecutor = (JavascriptExecutor) driver; } @Override public @Nullable Object executeScript(@Language("JavaScript") String script, @Nullable Object... args) { - return _executor.executeScript(script, args); + return _wrappedExecutor.executeScript(script, args); } @Override public @Nullable Object executeScript(ScriptKey key, @Nullable Object... args) { - return _executor.executeScript(key, args); + return _wrappedExecutor.executeScript(key, args); } /** @@ -49,7 +49,7 @@ public JavascriptExecutorWrapper(WebDriver driver) "try {" + script + "} catch (error) { callback(error); }"; // ensure that the callback is invoked when an exception would otherwise prevent it - return _executor.executeAsyncScript(script, arguments); + return _wrappedExecutor.executeAsyncScript(script, arguments); } public @Nullable T executeAsyncScript(@Language("JavaScript") String script, Class expectedResultType, @Nullable Object... arguments) @@ -68,18 +68,18 @@ public JavascriptExecutorWrapper(WebDriver driver) @Override public Set getPinnedScripts() { - return _executor.getPinnedScripts(); + return _wrappedExecutor.getPinnedScripts(); } @Override public void unpin(ScriptKey key) { - _executor.unpin(key); + _wrappedExecutor.unpin(key); } @Override public ScriptKey pin(@Language("JavaScript") String script) { - return _executor.pin(script); + return _wrappedExecutor.pin(script); } }