स्वाइप
डेस्कटॉप/मोबाइल वेब और मोबाइल नेटिव ऐप्स के लिए व्यूपोर्ट या तत्व के भीतर किसी विशिष्ट दिशा में स्वाइप करें।
मोबाइल नेटिव ऐप्स के लिए स्वाइपिंग W3C-एक्शन्स प्रोटोकॉल पर आधारित है, जो उंगली के दबाव और आंदोलन का अनुकरण करता है।
यह Android के लिए mobile: scrollGesture
या iOS के लिए mobile: scroll
कमांड से अलग है जो Appium ड्राइवर प्रोटोकॉल पर आधारित है और
केवल NATIVE संदर्भ में मोबाइल प्लेटफॉर्म के लिए उपलब्ध है।
यह कमांड केवल निम्नलिखित अप-टू-डेट कंपोनेंट्स के साथ काम करता है:
- Appium सर्वर (वर्जन 2.0.0 या उच्चतर)
appium-uiautomator2-driver
(Android के लिए)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 है। केवल-मोबाइल-नेटिव-ऐप |
नीचे (Down) प्रारंभिक बिंदु: आप अपनी उंगली को स्क्रीन के शीर्ष की ओर रखते हैं। आंदोलन: आप अपनी उंगली को नीचे की ओर स्क्रीन के निचले हिस्से की तरफ स्लाइड करते हैं। क्रिया: यह संदर्भ के अनुसार भिन्न होता है: - होम स्क्रीन पर या एप्लिकेशन में, यह आमतौर पर सामग्री को ऊपर की ओर स्क्रॉल करता है। - शीर्ष किनारे से, यह अक्सर नोटिफिकेशन पैनल या त्वरित सेट िंग्स खोलता है। - ब्राउज़र या पढ़ने वाले ऐप्स में, इसका उपयोग सामग्री के माध्यम से स्क्रॉल करने के लिए किया जा सकता है। | ||
बाएँ (Left) प्रारंभिक बिंदु: आप अपनी उंगली को स्क्रीन के दाईं ओर रखते हैं। आंदोलन: आप अपनी उंगली को क्षैतिज रूप से बाईं ओर स्लाइड करते हैं।> क्रिया: इस जेस्चर के प्रति प्रतिक्रिया एप्लिकेशन पर निर्भर करती है: - यह एक कैरोसेल या छवियों के सेट में अगले आइटम पर जा सकता है। - नेविगेशन संदर्भ में, यह पिछले पृष्ठ पर वापस जा सकता है या वर्तमान दृश्य को बंद कर सकता है। - होम स्क्रीन पर, यह आमतौर पर अगले वर्चुअल डेस्कटॉप या स्क्रीन पर स्विच करता है। | ||
दाएँ (Right) प्रारंभिक बिंदु: आप अपनी उंगली को स्क्रीन के बाईं ओर रखते हैं। आंदोलन: आप अपनी उंगली को क्षैतिज रूप से दाईं ओर स्लाइड करते हैं। क्रिय ा: बाएँ स्वाइप करने के समान, लेकिन विपरीत दिशा में: -- यह अक्सर कैरोसेल या गैलरी में पिछले आइटम पर जाता है। - ऐप्स में साइड मेनू या नेविगेशन ड्रॉअर खोलने के लिए इस्तेमाल किया जा सकता है। - होम स्क्रीन पर, यह आमतौर पर पिछले वर्चुअल डेस्कटॉप पर स्विच करता है। | ||
ऊपर (Up) प्रारंभिक बिंदु: आप अपनी उंगली को स्क्रीन के निचले हिस्से की ओर रखते हैं। आंदोलन: आप अपनी उंगली को ऊपर की ओर स्क्रीन के शीर्ष की तरफ स्लाइड करते हैं।> क्रिया: संदर्भ के आधार पर, विभिन्न क्रियाएँ हो सकती हैं: - होम स्क्रीन पर या सूची में, यह आमतौर पर सामग्री को नीचे की ओर स्क्रॉल करता है। - फुल-स्क्रीन ऐप में, यह अतिरिक्त विकल्प या ऐप ड्रॉअर खोल सकता है। - कुछ इंटरफेस पर, यह एक 'रिफ्रेश' क्रिया को ट्रिगर कर सकता है या सर्च बार खोल सकता है। | ||
options.duration वैकल्पिक | number | स्वाइप के लिए मिलीसेकंड में अवधि। डिफॉल्ट 1500 ms है। मान जितना कम होगा, स्वाइप उतना तेज होगा। |
options.scrollableElement वैकल्पिक | Element | वह तत्व जिसके भीतर स्वाइप करने के लिए उपयोग किया जाता है। यदि कोई तत्व प्रदान नहीं किया गया है तो यह iOS के लिए निम्न सेलेक्टर का उपयोग करेगा -ios predicate string:type == "XCUIElementTypeApplication" और Android के लिए निम्न का उपयोग करेगा //android.widget.ScrollView' । यदि डिफॉल्ट सेलेक्टर से अधिक तत्व मिलते हैं, तो डिफॉल्ट रूप से यह पहले मिलने वाले तत्व को चुनेगा। केवल-मोबाइल-नेटिव-ऐप |
options.percent वैकल्पिक | number | स्वाइप करने के लिए (डिफॉल्ट) स्क्रॉलेबल तत्व का प्रतिशत। यह 0 और 1 के बीच का मान है। डिफॉल्ट 0.95 है।कभी भी स्क्रीन के बिल्कुल शीर्ष|तल|बाएँ|दाएँ से स्वाइप न करें, आप उदाहरण के ल िए नोटिफिकेशन बार या अन्य OS/ऐप सुविधाओं को ट्रिगर कर सकते हैं जिससे अप्रत्याशित परिणाम हो सकते हैं। यदि 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
})
});