fix: update appium touchPerform method to perform a specific sequence of actions

Author: nlespiaucq

lib/helper/Appium.js

@@ -1330,36 +1330,49 @@ class Appium extends Webdriver {
   }
 
   /**
-   * Performs a specific touch action.
-   * The action object need to contain the action name, x/y coordinates
+   * Performs a specific touch action using W3C actions.
+   * The actions array should contain objects describing pointer actions.
    *
+   * Example: Tap at (100, 200)
    * ```js
-   * I.touchPerform([{
-   *     action: 'press',
-   *     options: {
-   *       x: 100,
-   *       y: 200
-   *     }
-   * }, {action: 'release'}])
-   *
-   * I.touchPerform([{
-   *    action: 'tap',
-   *    options: {
-   *        element: '1', // json web element was queried before
-   *        x: 10,   // x offset
-   *        y: 20,   // y offset
-   *        count: 1 // number of touches
-   *    }
-   * }]);
+   * I.touchPerform([
+   *   {
+   *     type: 'pointer',
+   *     id: 'finger1',
+   *     parameters: { pointerType: 'touch' },
+   *     actions: [
+   *       { type: 'pointerMove', duration: 0, x: 100, y: 200 },
+   *       { type: 'pointerDown', button: 0 },
+   *       { type: 'pointerUp', button: 0 },
+   *     ],
+   *   },
+   * ])
+   * ```
+   *
+   * Example: Press and hold at (100, 200) for 500ms, then release
+   * ```js
+   * I.touchPerform([
+   *   {
+   *     type: 'pointer',
+   *     id: 'finger1',
+   *     parameters: { pointerType: 'touch' },
+   *     actions: [
+   *       { type: 'pointerMove', duration: 0, x: 100, y: 200 },
+   *       { type: 'pointerDown', button: 0 },
+   *       { type: 'pause', duration: 500 },
+   *       { type: 'pointerUp', button: 0 }
+   *     ],
+   *   },
+   * ])
    * ```
    *
    * Appium: support Android and iOS
    *
-   * @param {Array} actions Array of touch actions
+   * @param {Array} actions Array of W3C pointer actions
    */
   async touchPerform(actions) {
     onlyForApps.call(this)
-    return this.browser.touchPerform(actions)
+    return this.browser.performActions(actions)
   }
 
   /**