Add minimize window command

Part of #683

Author: andrewnicols

lib/Remote/DriverCommand.php

@@ -151,6 +151,7 @@ class DriverCommand
     const GET_ELEMENT_PROPERTY = 'getElementProperty';
     const GET_NAMED_COOKIE = 'getNamedCookie';
     const TAKE_ELEMENT_SCREENSHOT = 'takeElementScreenshot';
+    const MINIMIZE_WINDOW = 'minimizeWindow';
 
     private function __construct()
     {

lib/Remote/HttpCommandExecutor.php

@@ -167,6 +167,7 @@ class HttpCommandExecutor implements WebDriverCommandExecutor
         DriverCommand::GET_WINDOW_SIZE => ['method' => 'GET', 'url' => '/session/:sessionId/window/rect'],
         DriverCommand::IMPLICITLY_WAIT => ['method' => 'POST', 'url' => '/session/:sessionId/timeouts'],
         DriverCommand::MAXIMIZE_WINDOW => ['method' => 'POST', 'url' => '/session/:sessionId/window/maximize'],
+        DriverCommand::MINIMIZE_WINDOW => ['method' => 'POST', 'url' => '/session/:sessionId/window/minimize'],
         DriverCommand::SET_ALERT_VALUE => ['method' => 'POST', 'url' => '/session/:sessionId/alert/text'],
         DriverCommand::SET_SCRIPT_TIMEOUT => ['method' => 'POST', 'url' => '/session/:sessionId/timeouts'],
         DriverCommand::SET_TIMEOUT => ['method' => 'POST', 'url' => '/session/:sessionId/timeouts'],

lib/WebDriverOptions.php

@@ -162,7 +162,7 @@ public function timeouts()
      */
     public function window()
     {
-        return new WebDriverWindow($this->executor);
+        return new WebDriverWindow($this->executor, $this->isW3cCompliant);
     }
 
     /**

lib/WebDriverWindow.php

@@ -16,6 +16,7 @@
 namespace Facebook\WebDriver;
 
 use Facebook\WebDriver\Exception\IndexOutOfBoundsException;
+use Facebook\WebDriver\Exception\UnsupportedOperationException;
 use Facebook\WebDriver\Remote\DriverCommand;
 use Facebook\WebDriver\Remote\ExecuteMethod;
 
@@ -28,10 +29,15 @@ class WebDriverWindow
      * @var ExecuteMethod
      */
     protected $executor;
+    /**
+     * @var bool
+     */
+    protected $isW3cCompliant;
 
-    public function __construct(ExecuteMethod $executor)
+    public function __construct(ExecuteMethod $executor, $isW3cCompliant = false)
     {
         $this->executor = $executor;
+        $this->isW3cCompliant = $isW3cCompliant;
     }
 
     /**
@@ -72,6 +78,22 @@ public function getSize()
         );
     }
 
+    /**
+     * Minimizes the current window if it is not already minimized.
+     *
+     * @return WebDriverWindow The instance.
+     */
+    public function minimize()
+    {
+        if (!$this->isW3cCompliant) {
+            throw new UnsupportedOperationException('Minimize window is only supported in W3C mode');
+        }
+
+        $this->executor->execute(DriverCommand::MINIMIZE_WINDOW, []);
+
+        return $this;
+    }
+
     /**
      * Maximizes the current window if it is not already maximized
      *

tests/functional/WebDriverWindowTest.php

@@ -48,6 +48,19 @@ public function testShouldMaximizeWindow()
         $this->assertGreaterThanOrEqual($sizeBefore->getHeight(), $sizeAfter->getHeight());
     }
 
+    public function testShouldMinimizeWindow()
+    {
+        self::skipForJsonWireProtocol('"minimize" window is not supported in JsonWire protocol');
+
+        $this->assertSame('visible', $this->driver->executeScript('return document.visibilityState;'));
+
+        $this->driver->manage()
+            ->window()
+            ->minimize();
+
+        $this->assertSame('hidden', $this->driver->executeScript('return document.visibilityState;'));
+    }
+
     /**
      * @group exclude-saucelabs
      */