Partial update to WebDriver W3C Candidate Recommendation 26 September 2017

Author: robocoder

lib/WebDriver/Alert.php

@@ -0,0 +1,47 @@
+<?php
+/**
+ * Copyright 2017-2017 Anthon Pang. All Rights Reserved.
+ *
+ * Licensed 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 WebDriver
+ *
+ * @author Anthon Pang <apang@softwaredevelopment.ca>
+ */
+
+namespace WebDriver;
+
+/**
+ * WebDriver\Alert class
+ *
+ * @package WebDriver
+ *
+ * @method array dismiss() Dismiss Alert
+ * @method array accept() Accept Alert
+ * @method array getText() Get Alert Text
+ * @method array postText() Send Alert Text
+ */
+final class Alert extends AbstractWebDriver
+{
+    /**
+     * {@inheritdoc}
+     */
+    protected function methods()
+    {
+        return array(
+            'dismiss' => array('POST'),
+            'accept' => array('POST'),
+            'text' => array('GET', 'POST'),
+        );
+    }
+}

lib/WebDriver/Element.php

@@ -43,6 +43,10 @@
  * @method array location_in_view() Determine an element's location on the screen once it has been scrolled into view.
  * @method array size() Determine an element's size in pixels.
  * @method string css($propertyName) Query the value of an element's computed CSS property.
+ * @method array property($propertyName) Get Element Property
+ * @method array rect() Get Element Rect
+ * @method array active() Get Active Element
+ * @method array screenshot() Take Element Screenshot
  */
 final class Element extends Container
 {
@@ -53,20 +57,26 @@ protected function methods()
     {
         return array(
             'click' => array('POST'),
-            'submit' => array('POST'),
             'text' => array('GET'),
             'value' => array('POST'),
             'name' => array('GET'),
             'clear' => array('POST'),
             'selected' => array('GET'),
             'enabled' => array('GET'),
             'attribute' => array('GET'),
+            'property' => array('GET'),
+            'css' => array('GET'),
+            'rect' => array('GET'),
+            'active' => array('GET'),
+            'screenshot' => array('GET'),
+
+            // Legacy JSON Wire Protocol
+            'submit' => array('POST'),
             'equals' => array('GET'),
             'displayed' => array('GET'),
             'location' => array('GET'),
             'location_in_view' => array('GET'),
             'size' => array('GET'),
-            'css' => array('GET'),
         );
     }
 

lib/WebDriver/Execute.php

@@ -0,0 +1,44 @@
+<?php
+/**
+ * Copyright 2017-2017 Anthon Pang. All Rights Reserved.
+ *
+ * Licensed 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 WebDriver
+ *
+ * @author Anthon Pang <apang@softwaredevelopment.ca>
+ */
+
+namespace WebDriver;
+
+/**
+ * WebDriver\Execute class
+ *
+ * @package WebDriver
+ *
+ * @method array sync() Execute Script
+ * @method array async() Execute Async Script
+ */
+final class Execute extends AbstractWebDriver
+{
+    /**
+     * {@inheritdoc}
+     */
+    protected function methods()
+    {
+        return array(
+            'sync' => array('POST'),
+            'async' => array('POST'),
+        );
+    }
+}

lib/WebDriver/Session.php

@@ -426,6 +426,37 @@ public function log()
         return new Log($this->url . '/log');
     }
 
+    /**
+     * alert method chaining, e.g.,
+     * - $session->alert()->text()
+     *
+     * @return mixed
+     */
+    public function alert()
+    {
+        return new Alert($this->url . '/alert');
+    }
+
+    /**
+     * script execution method chaining, e.g.,
+     * - $session->execute()->sync()
+     * - $session->execute()->async()
+     * - $session->execute() - fallback for legacy JSON Wire Protocol
+     *
+     * @return mixed
+     */
+    public function execute()
+    {
+        // execute script
+        if (func_num_args() === 0) {
+            $result = $this->curl('POST', '/execute');
+
+            return $result['value'];
+        }
+
+        return new Execute($this->url . '/execute');
+    }
+
     /**
      * {@inheritdoc}
      */