touchAction

Avertissement de dépréciation

La commande touchAction est dépréciée et sera supprimée dans une future version. Nous recommandons d'utiliser plutôt la commande action avec le type de pointeur touch, par exemple:

await browser.action('pointer', {
  parameters: { pointerType: 'touch' }
})

L'API Touch Action fournit la base de tous les gestes qui peuvent être automatisés dans Appium. Elle est actuellement disponible uniquement pour les applications natives et ne peut pas être utilisée pour interagir avec des applications web. À sa base se trouve la capacité d'enchaîner des actions individuelles ad hoc, qui seront ensuite appliquées à un élément dans l'application sur l'appareil. Les actions de base qui peuvent être utilisées sont:

• press (passer un élément ou (x, y) ou les deux)
• longPress (passer un élément ou (x, y) ou les deux)
• tap (passer un élément ou (x, y) ou les deux)
• moveTo (passer les coordonnées absolues x, y)
• wait (passer ms (en millisecondes))
• release (pas d'arguments)

Utilisation

browser.touchAction(action)

Paramètres

Nom	Type	Détails
action	TouchActions	action à exécuter

Exemple

touchAction.js

it('should do a touch gesture', async () => {
    const screen = await $('//UITextbox');

    // simple touch action on element
    await browser.touchAction({
        action: 'tap',
        element: screen
    });

    // simple touch action x y variables
    // tap location is 30px right and 20px down relative from the viewport
    await browser.touchAction({
        action: 'tap',
        x: 30,
        y:20
    })

    // simple touch action x y variables
    // tap location is 30px right and 20px down relative from the center of the element
    await browser.touchAction({
        action: 'tap',
        x: 30,
        y:20,
        element: screen
    })

    // multi action on an element
    // drag&drop from position 200x200 down 100px on the screen
    await browser.touchAction([
        { action: 'press', x: 200, y: 200 },
        { action: 'moveTo', x: 200, y: 300 },
        'release'
    ])
});