Skip to content

Commit

Permalink
[java] custom duration for Actions constructor (#14085)
Browse files Browse the repository at this point in the history
Co-authored-by: Titus Fortner <[email protected]>
Co-authored-by: Puja Jagani <[email protected]>
  • Loading branch information
3 people authored Jul 18, 2024
1 parent 10b3305 commit 72e3a61
Show file tree
Hide file tree
Showing 2 changed files with 95 additions and 3 deletions.
16 changes: 13 additions & 3 deletions java/src/org/openqa/selenium/interactions/Actions.java
Original file line number Diff line number Diff line change
Expand Up @@ -54,9 +54,15 @@ public class Actions {
private PointerInput activePointer;
private KeyInput activeKeyboard;
private WheelInput activeWheel;
private Duration actionDuration;

public Actions(WebDriver driver) {
this(driver, Duration.ofMillis(250));
}

public Actions(WebDriver driver, Duration duration) {
this.driver = Require.nonNull("Driver", driver);
this.actionDuration = duration;
}

/**
Expand Down Expand Up @@ -215,7 +221,7 @@ public Actions release(WebElement target) {
*/
public Actions scrollToElement(WebElement element) {
WheelInput.ScrollOrigin scrollOrigin = WheelInput.ScrollOrigin.fromElement(element);
return tick(getActiveWheel().createScroll(0, 0, 0, 0, Duration.ofMillis(250), scrollOrigin));
return tick(getActiveWheel().createScroll(0, 0, 0, 0, this.actionDuration, scrollOrigin));
}

/**
Expand All @@ -229,7 +235,7 @@ public Actions scrollToElement(WebElement element) {
public Actions scrollByAmount(int deltaX, int deltaY) {
WheelInput.ScrollOrigin scrollOrigin = WheelInput.ScrollOrigin.fromViewport();
return tick(
getActiveWheel().createScroll(0, 0, deltaX, deltaY, Duration.ofMillis(250), scrollOrigin));
getActiveWheel().createScroll(0, 0, deltaX, deltaY, this.actionDuration, scrollOrigin));
}

/**
Expand All @@ -249,7 +255,7 @@ public Actions scrollFromOrigin(WheelInput.ScrollOrigin scrollOrigin, int deltaX
int x = scrollOrigin.getxOffset();
int y = scrollOrigin.getyOffset();
return tick(
getActiveWheel().createScroll(x, y, deltaX, deltaY, Duration.ofMillis(250), scrollOrigin));
getActiveWheel().createScroll(x, y, deltaX, deltaY, this.actionDuration, scrollOrigin));
}

/**
Expand Down Expand Up @@ -548,6 +554,10 @@ public WheelInput getActiveWheel() {
return this.activeWheel;
}

public Duration getActionDuration() {
return this.actionDuration;
}

/**
* Generates a composite action containing all actions so far, ready to be performed (and resets
* the internal builder state, so subsequent calls to this method will contain fresh sequences).
Expand Down
82 changes: 82 additions & 0 deletions java/test/org/openqa/selenium/interactions/ActionDurationTest.java
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
// Licensed to the Software Freedom Conservancy (SFC) under one
// or more contributor license agreements. See the NOTICE file
// distributed with this work for additional information
// regarding copyright ownership. The SFC licenses this file
// to you under the Apache License, Version 2.0 (the
// "License"); you may not use this file except in compliance
// with the License. You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing,
// software distributed under the License is distributed on an
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
// KIND, either express or implied. See the License for the
// specific language governing permissions and limitations
// under the License.

package org.openqa.selenium.interactions;

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertFalse;
import static org.junit.jupiter.api.Assertions.assertTrue;

import java.time.Duration;
import org.junit.jupiter.api.Tag;
import org.junit.jupiter.api.Test;
import org.openqa.selenium.By;
import org.openqa.selenium.JavascriptExecutor;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.testing.JupiterTestBase;

@Tag("UnitTests")
class ActionDurationTest extends JupiterTestBase {
@Test
void shouldScrollToElementWithCustomDuration() {
driver.get(
appServer.whereIs("scrolling_tests/frame_with_nested_scrolling_frame_out_of_view.html"));
WebElement iframe = driver.findElement(By.tagName("iframe"));

assertFalse(inViewport(iframe));

new Actions(driver, Duration.ofMillis(111)).scrollToElement(iframe).perform();

assertTrue(inViewport(iframe));
}

@Test
void shouldScrollFromViewportByGivenAmountWithCustomDuration() {
driver.get(
appServer.whereIs("scrolling_tests/frame_with_nested_scrolling_frame_out_of_view.html"));
WebElement footer = driver.findElement(By.tagName("footer"));
int deltaY = footer.getRect().y;

new Actions(driver, Duration.ofMillis(111)).scrollByAmount(0, deltaY).perform();

assertTrue(inViewport(footer));
}

@Test
void shouldBeDefaultActionDuration250ms() {
Actions actions = new Actions(driver);
assertEquals(Duration.ofMillis(250), actions.getActionDuration());
}

@Test
void shouldBeCustomDuration110ms() {
Actions actions = new Actions(driver, Duration.ofMillis(110));
assertEquals(Duration.ofMillis(110), actions.getActionDuration());
}

private boolean inViewport(WebElement element) {

String script =
"for(var e=arguments[0],f=e.offsetTop,t=e.offsetLeft,o=e.offsetWidth,n=e.offsetHeight;\n"
+ "e.offsetParent;)f+=(e=e.offsetParent).offsetTop,t+=e.offsetLeft;\n"
+ "return"
+ " f<window.pageYOffset+window.innerHeight&&t<window.pageXOffset+window.innerWidth&&f+n>\n"
+ "window.pageYOffset&&t+o>window.pageXOffset";

return (boolean) ((JavascriptExecutor) driver).executeScript(script, element);
}
}

0 comments on commit 72e3a61

Please sign in to comment.