svep
Svep i en specifik riktning inom viewport eller element för Desktop/Mobil Webb OCH Mobila Applikationer.
Svepning för Mobila Applikationer baseras på W3C-actions protokollet, som simulerar ett fingertryck och rörelse.
Detta skiljer sig från mobile: scrollGesture
för Android
eller mobile: scroll
för iOS-kommandot som baseras på Appium Driver-protokollet och är
endast tillgängligt för mobila plattformar i NATIVE-kontext.
Detta kommando fungerar endast med följande uppdaterade komponenter:
- Appium server (version 2.0.0 eller högre)
appium-uiautomator2-driver
(för Android)appium-xcuitest-driver
(för iOS)
Se till att din lokala eller molnbaserade Appium-miljö uppdateras regelbundet för att undvika kompatibilitetsproblem.
Undvik att använda alternativen from
och to
om det inte är absolut nödvändigt. Dessa är enhetsspecifika och fungerar kanske inte konsekvent på olika enheter.
Använd alternativet scrollableElement
för pålitliga svep inom ett element.
Parameters
Name | Type | Details |
---|---|---|
options optional | object, boolean | alternativ för browser.swipe() . Standard för desktop/mobil webb: { direction: 'up', duration: 1500, percent: 0.95, scrollableElement: WebdriverIO.Element } |
options.direction optional | string | Kan vara en av down , up , left eller right , standard är up . ENDAST-MOBIL-NATIV-APP |
Down Startpunkt: Du placerar ditt finger mot toppen av skärmen. Rörelse: Du glider fingret nedåt mot botten av skärmen. Handling: Detta varierar också beroende på sammanhang: - På hemskärmen eller i applikationer, scrollar det vanligtvis innehållet uppåt. - Från övre kanten öppnar det ofta aviseringspanelen eller snabbinställningar. - I webbläsare eller läsappar kan det användas för att bläddra genom innehåll. | ||
Left Startpunkt: Du placerar ditt finger på höger sida av skärmen. Rörelse: Du glider fingret horisontellt till vänster.> Handling: Svaret på denna gest beror på applikationen: - Det kan flytta till nästa objekt i en karusell eller en uppsättning bilder. - I ett navigationssammanhang kan det gå tillbaka till föregående sida eller stänga den aktuella vyn. - På hemskärmen växlar det vanligtvis till nästa virtuella skrivbord eller skärm. | ||
Right Startpunkt: Du placerar ditt finger på vänster sida av skärmen. Rörelse: Du glider fingret horisontellt till höger. Handling: Liknande att svepa åt vänster, men i motsatt riktning: -- Det flyttar ofta till föregående objekt i en karusell eller galleri. - Kan användas för att öppna sidomenyer eller navigeringslådor i appar. - På hemskärmen växlar det vanligtvis till föregående virtuella skrivbord. | ||
Up Startpunkt: Du placerar ditt finger mot botten av skärmen. Rörelse: Du glider fingret uppåt mot toppen av skärmen.> Handling: Beroende på sammanhanget kan olika åtgärder inträffa: - På hemskärmen eller i en lista, scrollar detta vanligtvis innehållet nedåt. - I en fullskärmsapp kan det öppna ytterligare alternativ eller applådan. - På vissa gränssnitt kan det utlösa en "uppdatera"-åtgärd eller öppna ett sökfält. | ||
options.duration optional | number | Varaktigheten i millisekunder för svepningen. Standard är 1500 ms. Ju lägre värde, desto snabbare svepning. |
options.scrollableElement optional | Element | Element som används för att svepa inom. Om inget element anges kommer den att använda följande väljare för iOS -ios predicate string:type == "XCUIElementTypeApplication" och följande för Android //android.widget.ScrollView' . Om flera element matchar standardväljaren kommer den som standard att välja det första matchande elementet. ENDAST-MOBIL-NATIV-APP |
options.percent optional | number | Procentandelen av det (standard) scrollbara elementet att svepa. Detta är ett värde mellan 0 och 1. Standard är 0.95 .ALDRIG svep från exakt topp|botten|vänster|höger på skärmen, du kan utlösa till exempel aviseringsfältet eller andra OS/App-funktioner som kan leda till oväntade resultat. Detta har ingen effekt om from och to tillhandahålls. |
Värdena nedan har ENDAST effekt om scrollableElement INTE tillhandahålls, annars ignoreras de. | ||
options.from optional | object | X- och y-koordinaterna för början av svepningen. Om ett scrollableElement tillhandahålls har dessa koordinater ingen effekt. |
options.from.x optional | number | X-koordinaten för början av svepningen. |
options.from.y optional | number | Y-koordinaten för början av svepningen. |
options.to optional | object | X- och y-koordinaterna för slutet av svepningen. Om ett scrollableElement tillhandahålls har dessa koordinater ingen effekt. |
options.to.x optional | number | X-koordinaten för slutet av svepningen. |
options.to.y optional | number | Y-koordinaten för slutet av svepningen. |
Examples
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
})
});