touchAction（タッチアクション）

非推奨警告

touchActionコマンドは__非推奨__となり、将来のバージョンで削除される予定です。 代わりに、ポインタータイプtouchを使用したactionコマンドを使用することをお勧めします：

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

タッチアクションAPIは、Appiumで自動化できるすべてのジェスチャーの基礎を提供します。 現在、ネイティブアプリでのみ利用可能で、ウェブアプリとの対話には使用できません。 その核心は、_アドホック_な個別のアクションを連鎖させる機能であり、これらはデバイス上のアプリケーション内の要素に適用されます。使用できる基本的なアクションは以下の通りです：

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