[java] Implementing "minimize window" command

SeleniumHQ · Mar 12, 2020 · 7b8ab9e · 7b8ab9e
1 parent 74179a8
commit 7b8ab9e
Show file tree

Hide file tree

Showing 6 changed files with 33 additions and 0 deletions.
diff --git a/java/client/src/org/openqa/selenium/WebDriver.java b/java/client/src/org/openqa/selenium/WebDriver.java
@@ -615,6 +615,14 @@ interface Window {
      */
     void maximize();
 
+    /**
+     * Minimizes the current window if it is not already minimized
+     * <p>
+     * See <a href="https://w3c.github.io/webdriver/#minimize-window">W3C WebDriver specification</a>
+     * for more details.
+     */
+    void minimize();
+
     /**
      * Fullscreen the current window if it is not already fullscreen
      * <p>

diff --git a/java/client/src/org/openqa/selenium/remote/DriverCommand.java b/java/client/src/org/openqa/selenium/remote/DriverCommand.java
@@ -308,6 +308,7 @@ static CommandPayload SET_CURRENT_WINDOW_SIZE(Dimension targetSize) {
   }
   String GET_CURRENT_WINDOW_SIZE = "getCurrentWindowSize";
   String MAXIMIZE_CURRENT_WINDOW = "maximizeCurrentWindow";
+  String MINIMIZE_CURRENT_WINDOW = "minimizeCurrentWindow";
   String FULLSCREEN_CURRENT_WINDOW = "fullscreenCurrentWindow";
 
   // Logging API

diff --git a/java/client/src/org/openqa/selenium/remote/RemoteWebDriver.java b/java/client/src/org/openqa/selenium/remote/RemoteWebDriver.java
@@ -906,6 +906,11 @@ public void maximize() {
         execute(DriverCommand.MAXIMIZE_CURRENT_WINDOW);
       }
 
+      @Override
+      public void minimize() {
+        execute(DriverCommand.MINIMIZE_CURRENT_WINDOW);
+      }
+
       @Override
       public void fullscreen() {
         execute(DriverCommand.FULLSCREEN_CURRENT_WINDOW);

diff --git a/java/client/src/org/openqa/selenium/remote/codec/w3c/W3CHttpCommandCodec.java b/java/client/src/org/openqa/selenium/remote/codec/w3c/W3CHttpCommandCodec.java
@@ -53,6 +53,7 @@
 import static org.openqa.selenium.remote.DriverCommand.GET_WINDOW_HANDLES;
 import static org.openqa.selenium.remote.DriverCommand.IS_ELEMENT_DISPLAYED;
 import static org.openqa.selenium.remote.DriverCommand.MAXIMIZE_CURRENT_WINDOW;
+import static org.openqa.selenium.remote.DriverCommand.MINIMIZE_CURRENT_WINDOW;
 import static org.openqa.selenium.remote.DriverCommand.MOUSE_DOWN;
 import static org.openqa.selenium.remote.DriverCommand.MOUSE_UP;
 import static org.openqa.selenium.remote.DriverCommand.MOVE_TO;
@@ -131,6 +132,7 @@ public W3CHttpCommandCodec() {
     alias(GET_SESSION_STORAGE_SIZE, EXECUTE_SCRIPT);
 
     defineCommand(MAXIMIZE_CURRENT_WINDOW, post("/session/:sessionId/window/maximize"));
+    defineCommand(MINIMIZE_CURRENT_WINDOW, post("/session/:sessionId/window/minimize"));
     defineCommand(GET_CURRENT_WINDOW_SIZE, get("/session/:sessionId/window/rect"));
     defineCommand(SET_CURRENT_WINDOW_SIZE, post("/session/:sessionId/window/rect"));
     alias(GET_CURRENT_WINDOW_POSITION, GET_CURRENT_WINDOW_SIZE);

diff --git a/java/client/src/org/openqa/selenium/support/events/EventFiringWebDriver.java b/java/client/src/org/openqa/selenium/support/events/EventFiringWebDriver.java
@@ -778,6 +778,11 @@ public void maximize() {
       window.maximize();
     }
 
+    @Override
+    public void minimize() {
+      window.minimize();
+    }
+
     @Override
     public void fullscreen() {
       window.fullscreen();

diff --git a/java/client/test/org/openqa/selenium/WindowTest.java b/java/client/test/org/openqa/selenium/WindowTest.java
@@ -161,6 +161,18 @@ public void testCanMaximizeTheWindowFromIframe() {
     enlargeBy(WebDriver.Window::maximize);
   }
 
+  @Test
+  @Ignore(travis = true)
+  public void canMinimizeTheWindow() {
+    // Browser window cannot be resized or moved on ANDROID (and most mobile platforms
+    // though others aren't defined in org.openqa.selenium.Platform).
+    assumeFalse(TestUtilities.getEffectivePlatform(driver).is(ANDROID));
+
+    changeSizeTo(new Dimension(640, 323));
+    driver.manage().window().minimize();
+    // TODO: how to verify the result of this operation?
+  }
+
   @Test
   @Ignore(travis = true)
   @Ignore(SAFARI)