touchAction

Ostrzeżenie o przestarzałości

Komenda touchAction jest przestarzała i zostanie usunięta w przyszłej wersji. Zalecamy zamiast tego używanie komendy action z typem wskaźnika touch, np.:

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

Interfejs API Touch Action zapewnia podstawę wszystkich gestów, które można zautomatyzować w Appium. Jest obecnie dostępny tylko dla natywnych aplikacji i nie może być używany do interakcji z aplikacjami webowymi. Jego istotą jest możliwość łączenia poszczególnych działań ad hoc, które następnie zostaną zastosowane do elementu w aplikacji na urządzeniu. Podstawowe działania, które można wykorzystać to:

• press (przekaż element lub (x, y) lub obydwa)
• longPress (przekaż element lub (x, y) lub obydwa)
• tap (przekaż element lub (x, y) lub obydwa)
• moveTo (przekaż bezwzględne współrzędne x, y)
• wait (przekaż ms (jako milisekundy))
• release (bez argumentów)

Użycie

browser.touchAction(action)

Parametry

Nazwa	Typ	Szczegóły
action	TouchActions	akcja do wykonania

Przykład

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