پرش به محتوای اصلی

سوایپ

سوایپ در جهت خاص در ویوپورت یا المان برای وب دسکتاپ/موبایل و اپلیکیشن‌های بومی موبایل.

اطلاعات

سوایپ کردن برای اپلیکیشن‌های بومی موبایل بر اساس پروتکل 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 نقطه پایان سوایپ.
مثال‌ها
swipe.js
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();
});

swipe.with.options.js
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
})
});

Welcome! How can I help?

WebdriverIO AI Copilot