Implement various additional wire protocol commands.

Logging
Orientation
Equals
ActiveElement

Author: ashleydw

lib/WebDriverCommandExecutor.php

@@ -19,5 +19,5 @@
 interface WebDriverCommandExecutor {
 
   // $command and $params will be merged to an command object in the future.
-  public function execute($command, array $params);
+  public function execute($command, array $params =  array());
 }

lib/WebDriverOptions.php

@@ -131,4 +131,26 @@ public function timeouts() {
   public function window() {
     return new WebDriverWindow($this->executor);
   }
+
+  /**
+   * Get the log for a given log type. Log buffer is reset after each request.
+   *
+   * @param The log type (https://code.google.com/p/selenium/wiki/JsonWireProtocol#Log_Type)
+   * @return array The list of log entries.
+   */
+  public function getLog($logType) {
+    return $this->executor->execute('getLog', array(
+      'type' => $logType
+    ));
+  }
+
+  /**
+   * Get available log types.
+   *
+   * @return array The list of available log types (https://code.google.com/p/selenium/wiki/JsonWireProtocol#Log_Type)
+   */
+  public function getAvailableLogTypes() {
+    return $this->executor->execute('getAvailableLogTypes');
+  }
+
 }

lib/WebDriverWindow.php

@@ -106,4 +106,34 @@ public function setPosition(WebDriverPoint $position) {
     $this->executor->execute('setWindowPosition', $params);
     return $this;
   }
+
+  /**
+   * Get the current browser orientation.
+   *
+   * @return string Either LANDSCAPE|PORTRAIT
+   */
+  public function getScreenOrientation() {
+    return $this->executor->execute('getScreenOrientation');
+  }
+
+
+  /**
+   * Set the browser orientation. The orientation should either LANDSCAPE|PORTRAIT
+   *
+   * @param string $orientation
+   * @return WebDriverWindow The instance.
+   * @throws IndexOutOfBoundsWebDriverError
+   */
+  public function setScreenOrientation($orientation) {
+
+    $orientation = strtoupper($orientation);
+    if (!in_array($orientation, array('PORTRAIT', 'LANDSCAPE')))
+      throw new IndexOutOfBoundsWebDriverError("Orientation must be either PORTRAIT, or LANDSCAPE");
+
+    $this->executor->execute('setScreenOrientation', array('orientation' => $orientation));
+
+    return $this;
+
+  }
+
 }

lib/remote/HttpCommandExecutor.php

@@ -31,6 +31,7 @@ class HttpCommandExecutor implements WebDriverCommandExecutor {
     'deleteAllCookies' =>  array('method' => 'DELETE',  'url' => '/session/:sessionId/cookie'),
     'deleteCookie' =>      array('method' => 'DELETE',  'url' => '/session/:sessionId/cookie/:name'),
     'dismissAlert' =>       array('method' => 'POST',   'url' => '/session/:sessionId/dismiss_alert'),
+    'elementEquals' => array('method' => 'GET', 'url' => '/session/:sessionId/element/:id/equals/:other'),
     'elementFindElement' => array('method' => 'POST', 'url' => '/session/:sessionId/element/:id/element'),
     'elementFindElements' => array('method' => 'POST', 'url' => '/session/:sessionId/element/:id/elements'),
     'executeScript' =>     array('method' => 'POST', 'url' => '/session/:sessionId/execute'),
@@ -39,8 +40,10 @@ class HttpCommandExecutor implements WebDriverCommandExecutor {
     'focusFrame' =>       array('method' => 'POST',  'url' => '/session/:sessionId/frame'),
     'focusWindow' =>       array('method' => 'POST',  'url' => '/session/:sessionId/window'),
     'get' =>               array('method' => 'POST', 'url' => '/session/:sessionId/url'),
+    'getActiveElement' =>  array('method' => 'POST', 'url' => '/session/:sessionId/element/active'),
     'getAlertText' =>       array('method' => 'GET', 'url' => '/session/:sessionId/alert_text'),
     'getAllCookies' =>      array('method' => 'GET',  'url' => '/session/:sessionId/cookie'),
+    'getAvailableLogTypes' => array('method' => 'GET', 'url' => '/session/:sessionId/log/types'),
     'getCurrentURL' =>     array('method' => 'GET',  'url' => '/session/:sessionId/url'),
     'getCurrentWindowHandle' => array('method' => 'GET',  'url' => '/session/:sessionId/window_handle'),
     'getElementAttribute' => array('method' => 'GET',  'url' => '/session/:sessionId/element/:id/attribute/:name'),
@@ -50,7 +53,9 @@ class HttpCommandExecutor implements WebDriverCommandExecutor {
     'getElementSize' =>    array('method' => 'GET',  'url' => '/session/:sessionId/element/:id/size'),
     'getElementTagName' => array('method' => 'GET',  'url' => '/session/:sessionId/element/:id/name'),
     'getElementText' =>    array('method' => 'GET',  'url' => '/session/:sessionId/element/:id/text'),
+    'getLog' => array('method' => 'POST', 'url' => '/session/:sessionId/log'),
     'getPageSource' =>     array('method' => 'GET',  'url' => '/session/:sessionId/source'),
+    'getScreenOrientation' => array('method' => 'GET',  'url' => '/session/:sessionId/orientation'),
     'getSession' =>        array('method' => 'GET',  'url' => '/session/:sessionId'),
     'getTitle' =>          array('method' => 'GET',  'url' => '/session/:sessionId/title'),
     'getWindowHandles' => array('method' => 'GET',  'url' => '/session/:sessionId/window_handles'),
@@ -75,6 +80,7 @@ class HttpCommandExecutor implements WebDriverCommandExecutor {
     'sendKeysToAlert' =>    array('method' => 'POST', 'url' => '/session/:sessionId/alert_text'),
     'sendKeysToElement' => array('method' => 'POST', 'url' => '/session/:sessionId/element/:id/value'),
     'setImplicitWaitTimeout' => array('method' => 'POST', 'url' => '/session/:sessionId/timeouts/implicit_wait'),
+    'setScreenOrientation' => array('method' => 'POST', 'url' => '/session/:sessionId/orientation'),
     'setPageLoadTimeout' => array('method' => 'POST', 'url' => '/session/:sessionId/timeouts'),
     'setScriptTimeout' =>  array('method' => 'POST', 'url' => '/session/:sessionId/timeouts/async_script'),
     'setWindowPosition' => array('method' => 'POST', 'url' => '/session/:sessionId/window/:windowHandle/position'),

lib/remote/RemoteWebDriver.php

@@ -276,6 +276,16 @@ public function action() {
     return new WebDriverActions($this);
   }
 
+  /**
+   * Get the element on the page that currently has focus.
+   *
+   * @return WebDriverElement
+   */
+  public function getActiveElement() {
+    $response = $this->executor->execute('getActiveElement');
+    return $this->newElement($response['ELEMENT']);
+  }
+
   /**
    * Return the WebDriverElement with the given id.
    *

lib/remote/RemoteWebElement.php

@@ -280,6 +280,19 @@ public function getID() {
     return $this->id;
   }
 
+  /**
+   * Test if two element IDs refer to the same DOM element.
+   *
+   * @param WebDriverElement $other
+   * @return boolean
+   */
+  public function equals(WebDriverElement $other) {
+    return $this->executor->execute('elementEquals', array(
+      ':id'    => $this->id,
+      ':other' => $other->getID()
+    ));
+  }
+
   /**
    * Return the WebDriverElement with $id
    *

lib/support/events/EventFiringWebDriver.php

@@ -294,6 +294,19 @@ public function switchTo() {
     }
   }
 
+  /**
+   * Get the element on the page that currently has focus.
+   *
+   * @return WebDriverElement
+   */
+  public function getActiveElement() {
+    try {
+      return $this->driver->getActiveElement();
+    } catch (WebDriverException $exception) {
+      $this->dispatchOnException($exception);
+    }
+  }
+
   private function dispatchOnException($exception) {
     $this->dispatch('onException', $exception, $this);
     throw $exception;

lib/support/events/EventFiringWebElement.php

@@ -317,6 +317,21 @@ public function getID() {
     }
   }
 
+
+  /**
+   * Test if two element IDs refer to the same DOM element.
+   *
+   * @param WebDriverElement $other
+   * @return boolean
+   */
+  public function equals(WebDriverElement $other) {
+    try {
+      return $this->element->equals($other);
+    } catch (WebDriverException $exception) {
+      $this->dispatchOnException($exception);
+    }
+  }
+
   private function dispatchOnException($exception) {
     $this->dispatch(
       'onException',