سوایپ
سوایپ در جهت خاص در ویوپورت یا المان برای وب دسکتاپ/موبایل و اپلیکیشنهای بومی موبایل.
سوایپ کردن برای اپلیکیشنهای بومی موبایل بر اساس پروتکل W3C-actions است که فشار و حرکت انگشت را شبیهسازی میکند.
این با mobile: scrollGesture
برای اندروید
یا mobile: scroll
برای iOS متفاوت است که بر اساس پروتکل Appium Driver است و
فقط برای پلتفرمهای موبایل در محیط NATIVE در دسترس است.
این دستور فقط با اجزای بهروز زیر کار میکند:
- سرور Appium (نسخه 2.0.0 یا بالاتر)
appium-uiautomator2-driver
(برای اندروید)appium-xcuitest-driver
(برای iOS)
مطمئن شوید که محیط Appium محلی یا ابری شما به طور منظم بهروز میشود تا از مشکلات سازگاری جلوگیری شود.
از استفاده از گزینههای from
و to
خودداری کنید مگر اینکه کاملاً ضروری باشد. اینها مختص دستگاه هستند و ممکن است در دستگاههای مختلف به طور یکسان کار نکنند.
برای سوایپهای قابل اعتماد در یک عنصر، از گزینه scrollableElement
استفاده کنید.
پارامترها
نام | نوع | جزئیات |
---|---|---|
options اختیاری | object, boolean | گزینههای browser.swipe() . پیشفرض برای دسکتاپ/وب موبایل: { direction: 'up', duration: 1500, percent: 0.95, scrollableElement: WebdriverIO.Element } |
options.direction اختیاری | string | میتواند یکی از down ، up ، left یا right باشد، پیشفرض up است. فقط-اپلیکیشن-بومی-موبایل |
پایین نقطه شروع: انگشت خود را در قسمت بالای صفحه قرار میدهید. حرکت: انگشت خود را به سمت پایین صفحه حرکت میدهید. عملکرد: این نیز بسته به زمینه متفاوت است: - در صفحه اصلی یا در برنامهها، معمولاً محتوا را به سمت بالا اسکرول میکند. - از لبه بالایی، اغلب پنل اعلانها یا تنظیمات سریع را باز میکند. - در مرورگرها یا برنامههای خواندن، میتواند برای اسکرول محتوا استفاده شود. | ||
چپ نقطه شروع: انگشت خود را در سمت راست صفحه قرار میدهید. حرکت: انگشت خود را به صورت افقی به سمت چپ حرکت میدهید.> عملکرد: پاسخ به این حرکت به برنامه بستگی دارد: - میتواند به مورد بعدی در یک کاروسل یا مجموعهای از تصاویر حرکت کند. - در زمینه ناوبری، ممکن است به صفحه قبلی بازگردد یا نمای فعلی را ببندد. - در صفحه اصلی، معمولاً به دسکتاپ یا صفحه مجازی بعدی تغییر میکند. | ||
راست نقطه شروع: انگشت خود را در سمت چپ صفحه قرار میدهید. حرکت: انگشت خود را به صورت افقی به سمت راست حرکت میدهید. عملکرد: مشابه سوایپ به چپ، اما در جهت مخالف: -- اغلب به مورد قبلی در یک کاروسل یا گالری حرکت میکند. - میتواند برای باز کردن منوهای کناری یا کشوهای ناوبری در برنامهها استفاده شود. - در صفحه اصلی، معمولاً به دسکتاپ مجازی قبلی تغییر میکند. | ||
بالا نقطه شروع: انگشت خود را در قسمت پایین صفحه قرار میدهید. حرکت: انگشت خود را به سمت بالای صفحه حرکت میدهید.> عملکرد: بسته به زمینه، اقدامات مختلفی میتواند رخ دهد: - در صفحه اصلی یا در یک لیست، این معمولاً محتوا را به سمت پایین اسکرول میکند. - در یک برنامه تمام صفحه، ممکن است گزینههای اضافی یا کشوی برنامه را باز کند. - در برخی رابطها، ممکن است عمل 'تازهسازی' را فعال کند یا نوار جستجو را باز کند. | ||
options.duration اختیاری | number | مدت زمان سوایپ به میلیثانیه. پیشفرض 1500 میلیثانیه است. هرچه مقدار کمتر باشد، سوایپ سریعتر خواهد بود. |
options.scrollableElement اختیاری | Element | عنصری که برای سوایپ در داخل آن استفاده میشود. اگر هیچ عنصری ارائه نشود، از انتخابگر زیر برای iOS -ios predicate string:type == "XCUIElementTypeApplication" و برای اندروید //android.widget.ScrollView' استفاده میکند. اگر عناصر بیشتری با انتخابگر پیشفرض مطابقت داشته باشند، به طور پیشفرض اولین عنصر مطابق را انتخاب میکند. فقط-اپلیکیشن-بومی-موبایل |
options.percent اختیاری | number | درصد عنصر قابل اسکرول (پیشفرض) برای سوایپ. این مقداری بین 0 و 1 است. پیشفرض 0.95 است.هرگز از دقیقاً بالا|پایین|چپ|راست صفحه سوایپ نکنید، ممکن است به عنوان مثال نوار اعلان یا سایر ویژگیهای سیستمعامل/برنامه را فعال کنید که میتواند منجر به نتایج غیرمنتظره شود. اگر from و to ارائه شوند، این تأثیری ندارد. |
مقادیر زیر فقط در صورتی تأثیر دارند که scrollableElement ارائه نشده باشد، در غیر این صورت نادیده گرفته میشوند. | ||
options.from اختیاری | object | مختصات x و y شروع سوایپ. اگر scrollableElement ارائه شود، این مختصات تأثیری ندارند. |
options.from.x اختیاری | number | مختصات x نقطه شروع سوایپ. |
options.from.y اختیاری | number | مختصات y نقطه شروع سوایپ. |
options.to اختیاری | object | مختصات x و y پایان سوایپ. اگر scrollableElement ارائه شود، این مختصات تأثیری ندارند. |
options.to.x اختیاری | number | مختصات x نقطه پایان سوایپ. |
options.to.y اختیاری | number | مختصات y نقطه پایان سوایپ. |
مثالها
it('should execute a default swipe', async () => {
// Default will be a swipe from the bottom to the top, meaning it will swipe UP
await browser.swipe();
});
it('should execute a swipe with options', async () => {
await browser.swipe({
direction: 'left', // Swipe from right to left
duration: 5000, // Last for 5 seconds
percent: 0.5, // Swipe 50% of the scrollableElement
scrollableElement: $('~carousel'), // The element to swipe within
})
});