[java] [dotnet] Add move to location method to Actions (#11509)

pujagani · titusfortner · web-flow · commit 84724107cd27 · 2023-07-12T15:37:10.000-05:00
* [java] Add move to location method to Actions Related to #10724 * [dotnet] Add move to location method to Actions class * [java] only support one implementation of moveToLocation pointer action Co-authored-by: titusfortner <titus.fortner@gmail.com>
diff --git a/dotnet/src/webdriver/Interactions/Actions.cs b/dotnet/src/webdriver/Interactions/Actions.cs
@@ -437,6 +437,18 @@ public Actions MoveByOffset(int offsetX, int offsetY)
             return this;
         }
 
+        /// <summary>
+        /// Moves the mouse from the upper left corner of the current viewport by the provided offset.
+        /// </summary>
+        /// <param name="offsetX">The horizontal offset to which to move the mouse.</param>
+        /// <param name="offsetY">The vertical offset to which to move the mouse.</param>
+        /// <returns>A self-reference to this <see cref="Actions"/>.</returns>
+        public Actions MoveToLocation(int offsetX, int offsetY)
+        {
+            this.actionBuilder.AddAction(this.defaultMouse.CreatePointerMove(CoordinateOrigin.Viewport, offsetX, offsetY, DefaultMouseMoveDuration));
+            return this;
+        }
+
         /// <summary>
         /// Right-clicks the mouse on the specified element.
         /// </summary>
diff --git a/dotnet/test/common/DriverTestFixture.cs b/dotnet/test/common/DriverTestFixture.cs
@@ -72,6 +72,7 @@ public abstract class DriverTestFixture
         public string mapVisibilityPage = EnvironmentManager.Instance.UrlBuilder.WhereIs("map_visibility.html");
         public string mouseTrackerPage = EnvironmentManager.Instance.UrlBuilder.WhereIs("mousePositionTracker.html");
         public string mouseOverPage = EnvironmentManager.Instance.UrlBuilder.WhereIs("mouseOver.html");
+        public string mouseInteractionPage = EnvironmentManager.Instance.UrlBuilder.WhereIs("mouse_interaction.html");
         public string readOnlyPage = EnvironmentManager.Instance.UrlBuilder.WhereIs("readOnlyPage.html");
         public string clicksPage = EnvironmentManager.Instance.UrlBuilder.WhereIs("clicks.html");
         public string booleanAttributes = EnvironmentManager.Instance.UrlBuilder.WhereIs("booleanAttributes.html");
diff --git a/dotnet/test/common/Interactions/BasicMouseInterfaceTest.cs b/dotnet/test/common/Interactions/BasicMouseInterfaceTest.cs
@@ -145,6 +145,20 @@ public void ShouldAllowMoveAndClick()
             Assert.AreEqual("Clicked", toClick.GetAttribute("value"), "Value should change to Clicked.");
         }
 
+        [Test]
+        public void ShouldMoveToLocation()
+        {
+            driver.Url = mouseInteractionPage;
+
+            Actions actionProvider = new Actions(driver);
+            actionProvider.MoveToLocation(100, 200).Build().Perform();
+
+            IWebElement location = driver.FindElement(By.Id("absolute-location"));
+            var coordinates = location.Text.Split(',');
+            Assert.AreEqual("100", coordinates[0].Trim());
+            Assert.AreEqual("200", coordinates[1].Trim());
+        }
+
         [Test]
         public void ShouldNotMoveToANullLocator()
         {
@@ -456,6 +470,11 @@ private Func<bool> TitleToBe(string desiredTitle)
             return () => driver.Title == desiredTitle;
         }
 
+        private Func<bool> ValueToBe(IWebElement element, string desiredValue)
+        {
+            return () => element.GetDomProperty("value") == desiredValue;
+        }
+
         private Func<bool> ElementTextToEqual(IWebElement element, string text)
         {
             return () => element.Text == text;
diff --git a/java/src/org/openqa/selenium/interactions/Actions.java b/java/src/org/openqa/selenium/interactions/Actions.java
@@ -30,6 +30,7 @@
 import java.util.Set;
 import java.util.function.IntConsumer;
 import org.openqa.selenium.Keys;
+import org.openqa.selenium.Point;
 import org.openqa.selenium.WebDriver;
 import org.openqa.selenium.WebElement;
 import org.openqa.selenium.interactions.PointerInput.Origin;
@@ -352,9 +353,9 @@ private Actions moveInTicks(WebElement target, int xOffset, int yOffset) {
   }
 
   /**
-   * Moves the mouse from its current position (or 0,0) by the given offset. If the coordinates
-   * provided are outside the viewport (the mouse will end up outside the browser window) then the
-   * viewport is scrolled to match.
+   * Moves the mouse from its current position (or 0,0) by the given offset. If the final
+   * coordinates of the move are outside the viewport (the mouse will end up outside the browser window),
+   * an exception is raised.
    *
    * @param xOffset horizontal offset. A negative value means moving the mouse left.
    * @param yOffset vertical offset. A negative value means moving the mouse up.
@@ -368,6 +369,24 @@ public Actions moveByOffset(int xOffset, int yOffset) {
             .createPointerMove(Duration.ofMillis(200), Origin.pointer(), xOffset, yOffset));
   }
 
+  /**
+   * Moves the mouse to provided coordinates on screen regardless of starting position of
+   * the mouse. If the coordinates
+   * provided are outside the viewport (the mouse will end up outside the browser window),
+   * an exception is raised.
+   *
+   * @param xCoordinate positive pixel value along horizontal axis in viewport. Numbers increase going right.
+   * @param yCoordinate positive pixel value along vertical axis in viewport. Numbers increase going down.
+   * @return A self reference.
+   * @throws MoveTargetOutOfBoundsException if the provided offset is outside the document's
+   *     boundaries.
+   */
+  public Actions moveToLocation(int xCoordinate, int yCoordinate) {
+    return tick(
+      getActivePointer()
+        .createPointerMove(Duration.ofMillis(250), Origin.viewport(), xCoordinate, yCoordinate));
+  }
+
   /**
    * Performs a context-click at middle of the given element. First performs a mouseMove to the
    * location of the element.
diff --git a/java/test/org/openqa/selenium/interactions/DefaultMouseTest.java b/java/test/org/openqa/selenium/interactions/DefaultMouseTest.java
@@ -190,6 +190,19 @@ void testContextClick() {
     assertThat(toContextClick.getAttribute("value")).isEqualTo("ContextClicked");
   }
 
+  @Test
+  void testMoveToLocation() {
+    driver.get(pages.mouseInteractionPage);
+
+    Action moveAndClick = getBuilder(driver).moveToLocation(70, 60).click().build();
+
+    moveAndClick.perform();
+
+    WebElement element = driver.findElement(By.id("greeting"));
+
+    assertThat(element.getText()).isEqualTo("Success!");
+  }
+
   @Test
   void testMoveAndClick() {
     driver.get(pages.javascriptPage);
