touchAction

Попередження про застарілість

Команда touchAction є застарілою і буде видалена в майбутніх версіях. Ми рекомендуємо натомість використовувати команду action з типом вказівника touch, наприклад:

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

Touch Action API забезпечує основу всіх жестів, які можна автоматизувати в Appium. Наразі вона доступна лише для нативних додатків і не може використовуватися для взаємодії з веб-додатками. Її основою є можливість об'єднувати в ланцюжок ad hoc окремі дії, які потім будуть застосовані до елемента в додатку на пристрої. Основні дії, які можна використовувати:

• press (передати елемент або (x, y) або обидва)
• longPress (передати елемент або (x, y) або обидва)
• tap (передати елемент або (x, y) або обидва)
• moveTo (передати абсолютні координати x, y)
• wait (передати ms (як мілісекунди))
• release (без аргументів)

Використання

browser.touchAction(action)

Параметри

Ім'я	Тип	Деталі
action	TouchActions	дія для виконання

Приклад

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'
    ])
});