touchAction

弃用警告

touchAction 命令已**弃用**，将在未来版本中删除。我们建议改用 action 命令，并使用指针类型 touch，例如：

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

触摸操作 API 提供了 Appium 中所有可自动化的手势的基础。它目前仅适用于原生应用，不能用于与 Web 应用交互。其核心是能够将临时的单个操作链接在一起，然后将其应用于设备上应用程序中的元素。可使用的基本操作为

• press（传递元素或（x，y）或两者）
• longPress（传递元素或（x，y）或两者）
• tap（传递元素或（x，y）或两者）
• moveTo（传递绝对的x，y坐标）
• wait（传递ms（以毫秒为单位））
• release（无参数）

用法

browser.touchAction(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'
    ])
});