browser: add global send keys (#1596)

Author: MykolaGolubyev

webtau-browser/src/main/java/org/testingisdocumenting/webtau/browser/Browser.java

@@ -19,14 +19,12 @@
 
 import org.openqa.selenium.OutputType;
 import org.openqa.selenium.WebDriver;
+import org.openqa.selenium.interactions.Actions;
 import org.testingisdocumenting.webtau.browser.documentation.BrowserDocumentation;
 import org.testingisdocumenting.webtau.browser.driver.CurrentWebDriver;
 import org.testingisdocumenting.webtau.browser.driver.WebDriverCreator;
 import org.testingisdocumenting.webtau.browser.navigation.BrowserPageNavigation;
-import org.testingisdocumenting.webtau.browser.page.TablePageElement;
-import org.testingisdocumenting.webtau.browser.page.PageElement;
-import org.testingisdocumenting.webtau.browser.page.PageElementValue;
-import org.testingisdocumenting.webtau.browser.page.PageUrl;
+import org.testingisdocumenting.webtau.browser.page.*;
 import org.testingisdocumenting.webtau.browser.page.path.PageElementPath;
 import org.testingisdocumenting.webtau.cache.Cache;
 import org.testingisdocumenting.webtau.reporter.TokenizedMessage;
@@ -182,6 +180,14 @@ public TablePageElement table(PageElement pageElement) {
         return new TablePageElement(pageElement);
     }
 
+    public void sendKeys(CharSequence keys) {
+        String renderedKeys = BrowserKeysRenderer.renderKeys(keys);
+
+        createAndExecuteStep(tokenizedMessage().action("sending keys").string(renderedKeys).to().id("browser"),
+                () -> tokenizedMessage().action("sent keys").string(renderedKeys).to().id("browser"),
+                () -> new Actions(driver).sendKeys(keys).perform());
+    }
+
     public boolean hasActiveBrowsers() {
         return WebDriverCreator.hasActiveBrowsers();
     }

webtau-browser/src/main/java/org/testingisdocumenting/webtau/browser/page/PageElement.java

@@ -402,7 +402,6 @@ private void clickWithKey(String label, CharSequence key) {
                         .perform());
     }
 
-
     private Object extractSingleValue() {
         List<WebElement> elements = path.find(driver);
         if (elements.isEmpty()) {

webtau-docs/znai/release-notes/2.4/add-2024-06-04-browser-global-send-keys.md

@@ -0,0 +1 @@
+* Add: [browser](browser/introduction)`.sendKeys` to send keys to the window instead of a specific element

…24-05-14-http-contain-exactly-markers.md …24-05-14-http-contain-exactly-markers.mdwebtau-docs/znai/release-notes/2.4/add-2024-05-14-http-contain-exactly-markers.md renamed to webtau-docs/znai/release-notes/2.4/fix-2024-05-14-http-contain-exactly-markers.md webtau-docs/znai/release-notes/2.4/add-2024-05-14-http-contain-exactly-markers.md renamed to webtau-docs/znai/release-notes/2.4/fix-2024-05-14-http-contain-exactly-markers.md

@@ -0,0 +1,16 @@
+package scenarios.ui
+
+import static org.testingisdocumenting.webtau.WebTauGroovyDsl.*
+
+def searchBox = $("#search-box")
+def numberOfResults = $(".result").count
+
+scenario('send keys to browser') {
+    browser.open("/search")
+    searchBox.click()
+
+    browser.sendKeys("search this")
+    browser.sendKeys(browser.keys.enter)
+
+    numberOfResults.shouldBe > 1
+}

webtau-feature-testing/examples/scenarios/ui/globalSendKeys.groovy

@@ -370,6 +370,11 @@ class WebTauBrowserFeaturesTestBase {
         runCli("searchWithPersonas.groovy", "webtau.cfg.groovy")
     }
 
+    @Test
+    void "global send keys"() {
+        runCli("globalSendKeys.groovy", "webtau.cfg.groovy")
+    }
+
     @Test
     void "ag grid multi select"() {
         runCli("agGridMultiSelect.groovy", "webtau.cfg.groovy")

webtau-feature-testing/src/test/groovy/org/testingisdocumenting/webtau/featuretesting/WebTauBrowserFeaturesTestBase.groovy

@@ -0,0 +1,16 @@
+{
+  "scenarioDetails" : [ {
+    "scenario" : "after all tests",
+    "shortContainerId" : "Teardown",
+    "stepsSummary" : {
+      "numberOfSuccessful" : 1
+    }
+  }, {
+    "scenario" : "send keys to browser",
+    "shortContainerId" : "globalSendKeys.groovy",
+    "stepsSummary" : {
+      "numberOfSuccessful" : 6
+    }
+  } ],
+  "exitCode" : 0
+}

webtau-feature-testing/test-expectations/scenarios/ui/globalSendKeys/chrome-run-details.json

@@ -0,0 +1,16 @@
+{
+  "scenarioDetails" : [ {
+    "scenario" : "after all tests",
+    "shortContainerId" : "Teardown",
+    "stepsSummary" : {
+      "numberOfSuccessful" : 1
+    }
+  }, {
+    "scenario" : "send keys to browser",
+    "shortContainerId" : "globalSendKeys.groovy",
+    "stepsSummary" : {
+      "numberOfSuccessful" : 6
+    }
+  } ],
+  "exitCode" : 0
+}