DoubleTap Support

Author: rafe-g

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

@@ -395,6 +395,22 @@ public void performMultiTouchAction(
 
         multiTouch.perform();
     }
+    
+    /**
+     * Double taps element
+     */
+    public void doubleTap(WebElement element, int x, int y) {
+    	TouchAction action = new TouchAction(this);
+    	action.doubleTap(element, x, y).perform();
+    }
+    
+    /**
+     * Double taps element
+     */
+    public void doubleTap(WebElement element) {
+    	TouchAction action = new TouchAction(this);
+    	action.doubleTap(element).perform();
+    }
 
     /**
      * @see TouchShortcuts#tap(int, int, int, int).

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

@@ -184,7 +184,37 @@ 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.
+     * @param x  x offset.
+     * @param y  y offset.
+     * @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,24 @@ public interface TouchShortcuts {
      * @param el The element to pinch.
      */
     void zoom(WebElement el);
+    
+	/**
+	 * Convenience method for double tapping element at a coordinate
+	 * 
+	 * @param element
+	 * @param x
+	 * @param y
+	 */
+    void doubleTap(WebElement element, int x, int y);
+
+	/**
+	 * Convenience method for double tapping center of an element
+	 * 
+	 * @param element
+	 * @param x
+	 * @param y
+	 */
+    void doubleTap(WebElement element);
 
     /**
      * Convenience method for tapping a position on the screen.

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,15 @@ 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");
+        String textAfterDoubleTap = (driver.findElementByClassName("android.widget.TextView")).getText();
+        assertFalse(textBeforeDoubleTap.equals(textAfterDoubleTap));
+        assertTrue(textAfterDoubleTap.equals("2"));
+    }
+    
     @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");