DoubleTap Support

Author: rafe-g

src/main/java/io/appium/java_client/TouchAction.java

@@ -184,7 +184,35 @@ public TouchAction tap(WebElement el, int x, int y) {
         parameterBuilder.add(action);
         return this;
     }
+    
+    /**
+     * Double taps an element, offset from upper left corner.
+     *
+     * @param el element to tap.
+     * @param x  x offset.
+     * @param y  y offset.
+     * @return this TouchAction, for chaining.
+     */    
+    public TouchAction doubleTap(WebElement el, int x, int y) {
+        ActionParameter action = new ActionParameter("doubleTap", (HasIdentity) el);
+        action.addParameter("x", x);
+        action.addParameter("y", y);
+        parameterBuilder.add(action);
+        return this;
+    }
 
+    /**
+     * Double taps an element, offset from upper left corner.
+     *
+     * @param el element to tap.
+     * @return this TouchAction, for chaining.
+     */    
+    public TouchAction doubleTap(WebElement el) {
+        ActionParameter action = new ActionParameter("doubleTap", (HasIdentity) el);
+        parameterBuilder.add(action);
+        return this;
+    }
+    
     /**
      * A wait action, used as a NOP in multi-chaining.
      *

src/main/java/io/appium/java_client/TouchShortcuts.java

@@ -48,6 +48,22 @@ public interface TouchShortcuts {
      * @param el The element to pinch.
      */
     void zoom(WebElement el);
+    
+    /**
+     * Convenience method for double tapping element at a coordinate.
+     * 
+     * @param element we want to double tap.
+     * @param x       x coordinate.
+     * @param y       y coordinate.
+     */
+    void doubleTap(WebElement element, int x, int y);
+
+    /**
+     * Convenience method for double tapping center of an element.
+     * 
+     * @param element we want to double tap.
+     */
+    void doubleTap(WebElement element);
 
     /**
      * Convenience method for tapping a position on the screen.

src/main/java/io/appium/java_client/android/AndroidDriver.java

@@ -37,6 +37,7 @@
 import io.appium.java_client.CommandExecutionHelper;
 import io.appium.java_client.FindsByAndroidUIAutomator;
 import io.appium.java_client.MobileSelector;
+import io.appium.java_client.TouchAction;
 import io.appium.java_client.android.internal.JsonToAndroidElementConverter;
 import io.appium.java_client.remote.MobilePlatform;
 import io.appium.java_client.service.local.AppiumDriverLocalService;
@@ -389,4 +390,18 @@ public void lockDevice() {
     public void unlockDevice() {
         CommandExecutionHelper.execute(this, unlockCommand());
     }
+    
+    /**
+     * @see TouchShortcuts#doubleTap(WebElement, int, int).
+     */
+    @Override public void doubleTap(WebElement element, int x, int y) {
+        throw new UnsupportedOperationException("Support has not been added in the android driver.");
+    }
+    
+    /**
+     * @see TouchShortcuts#doubleTap(WebElement).
+     */
+    @Override public void doubleTap(WebElement element) {
+        throw new UnsupportedOperationException("Support has not been added in the android driver.");
+    }
 }

src/main/java/io/appium/java_client/ios/IOSDriver.java

@@ -25,6 +25,7 @@
 import io.appium.java_client.CommandExecutionHelper;
 import io.appium.java_client.FindsByIosUIAutomation;
 import io.appium.java_client.MobileSelector;
+import io.appium.java_client.TouchAction;
 import io.appium.java_client.ios.internal.JsonToIOSElementConverter;
 import io.appium.java_client.remote.MobilePlatform;
 import io.appium.java_client.service.local.AppiumDriverLocalService;
@@ -272,4 +273,20 @@ class IOSAlert implements Alert {
         }
 
     }
+    
+    /**
+     * @see TouchShortcuts#doubleTap(WebElement, int, int).
+     */
+    @Override public void doubleTap(WebElement element, int x, int y) {
+        TouchAction action = new TouchAction(this);
+        action.doubleTap(element, x, y).perform();
+    }
+    
+    /**
+     * @see TouchShortcuts#doubleTap(WebElement).
+     */
+    @Override public void doubleTap(WebElement element) {
+        TouchAction action = new TouchAction(this);
+        action.doubleTap(element).perform();
+    }
 }

src/main/java/io/appium/java_client/youiengine/YouiEngineDriver.java

@@ -39,4 +39,18 @@ public void swipe(int startx, int starty, int endx, int endy, int duration) {
                 .release();
         swipeAction.perform();
     }
+    
+    /**
+     * @see TouchShortcuts#doubleTap(WebElement, int, int).
+     */
+    @Override public void doubleTap(WebElement element, int x, int y) {
+        throw new UnsupportedOperationException("Support has not been added in the YouiEngineDriver.");
+    }
+    
+    /**
+     * @see TouchShortcuts#doubleTap(WebElement).
+     */
+    @Override public void doubleTap(WebElement element) {
+        throw new UnsupportedOperationException("Support has not been added in the YouiEngineDriver.");
+    }
 }

src/main/java/org/openqa/selenium/WebDriver.java

@@ -17,8 +17,8 @@
 
 package org.openqa.selenium;
 
-import org.openqa.selenium.logging.Logs;
 import org.openqa.selenium.logging.LoggingPreferences;
+import org.openqa.selenium.logging.Logs;
 
 import java.net.URL;
 import java.util.List;

src/test/java/io/appium/java_client/android/AndroidGestureTest.java

@@ -18,6 +18,8 @@
 
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertNotEquals;
+import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertTrue;
 
 import io.appium.java_client.MobileBy;
 import io.appium.java_client.MobileElement;
@@ -40,6 +42,16 @@ public class AndroidGestureTest extends BaseAndroidTest {
             .findElementById("io.appium.android.apis:id/button_toggle").getText());
     }
 
+    @Test public void doubleTapTest() throws Exception {
+        driver.startActivity("io.appium.android.apis", ".view.TextSwitcher1");
+        String textBeforeDoubleTap = (driver.findElementByClassName("android.widget.TextView")).getText();
+        AndroidElement next = driver.findElementById("io.appium.android.apis:id/next");
+        driver.doubleTap(next);
+        String textAfterDoubleTap = (driver.findElementByClassName("android.widget.TextView")).getText();
+        assertFalse(textBeforeDoubleTap.equals(textAfterDoubleTap));
+        assertTrue("2".equals(textAfterDoubleTap));
+    }
+    
     @Test public void singleElementTapTest() throws Exception {
         driver.startActivity("io.appium.android.apis", ".view.Buttons1");
         driver.tap(1, driver.findElementById("io.appium.android.apis:id/button_toggle"), 1000);

src/test/java/io/appium/java_client/ios/IOSGesturesTest.java

@@ -17,6 +17,7 @@
 package io.appium.java_client.ios;
 
 import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertNotNull;
 
 import io.appium.java_client.MobileElement;
 import io.appium.java_client.SwipeElementDirection;
@@ -33,6 +34,14 @@ public class IOSGesturesTest extends BaseIOSTest {
         driver.tap(2, e, 2000);
         assertEquals(driver.findElementByXPath("//*[@name = \"Answer\"]").getText(), "6");
     }
+    
+    @Test public void doubleTapTest() {
+        IOSElement firstField = (IOSElement) driver.findElementById("IntegerA");
+        firstField.sendKeys("2");
+        driver.doubleTap(firstField);
+        IOSElement editingMenu = (IOSElement) driver.findElementByClassName("UIAEditingMenu");
+        assertNotNull(editingMenu);
+    }
 
     @Test public void zoomTest() {
         MobileElement e = driver.findElementById("IntegerA");