اللمس المتقدم

تحذير من الانتهاء

أمر touchAction مهمل وسيتم إزالته في إصدار مستقبلي. نوصي باستخدام أمر action بدلاً من ذلك مع نوع المؤشر touch، على سبيل المثال:

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

توفر واجهة برمجة تطبيقات Touch Action الأساس لجميع الإيماءات التي يمكن أتمتتها في 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'
    ])
});