wischen

Wische in eine bestimmte Richtung innerhalb des Viewports oder Elements für Desktop/Mobile Web UND Mobile Native Apps.

Info

Das Wischen für Mobile Native Apps basiert auf dem W3C-Actions-Protokoll und simuliert einen Fingerdruck und eine Bewegung. Dies unterscheidet sich vom mobile: scrollGesture für Android oder mobile: scroll für iOS-Befehle, die auf dem Appium Driver Protokoll basieren und nur für mobile Plattformen im NATIVE-Kontext verfügbar sind.

Dieser Befehl funktioniert nur mit den folgenden aktuellen Komponenten:

Appium Server (Version 2.0.0 oder höher)
appium-uiautomator2-driver (für Android)
appium-xcuitest-driver (für iOS)

Stelle sicher, dass deine lokale oder Cloud-basierte Appium-Umgebung regelmäßig aktualisiert wird, um Kompatibilitätsprobleme zu vermeiden.

Wischen basierend auf Koordinaten

Vermeide die Verwendung von from und to Optionen, es sei denn, es ist unbedingt notwendig. Diese sind gerätespezifisch und funktionieren möglicherweise nicht konsistent auf verschiedenen Geräten. Verwende die Option scrollableElement für zuverlässige Wischgesten innerhalb eines Elements.

Parameter

Name	Type	Details
`options` optional	`object, boolean`	Optionen für `browser.swipe()`. Standard für Desktop/Mobile Web: `{ direction: 'up', duration: 1500, percent: 0.95, scrollableElement: WebdriverIO.Element }`
`options.direction` optional	`string`	Kann einer von `down`, `up`, `left` oder `right` sein, Standard ist `up`. NUR-FÜR-MOBILE-NATIVE-APPS
Down (Nach unten) Ausgangspunkt: Du platzierst deinen Finger in Richtung der Oberseite des Bildschirms. Bewegung: Du gleitest mit deinem Finger nach unten in Richtung der Unterseite des Bildschirms. Aktion: Dies variiert je nach Kontext: - Auf dem Startbildschirm oder in Anwendungen scrollt es typischerweise den Inhalt nach oben. - Vom oberen Rand aus öffnet es oft das Benachrichtigungsfenster oder Schnelleinstellungen. - In Browsern oder Lese-Apps kann es zum Scrollen durch Inhalte verwendet werden.
Left (Nach links) Ausgangspunkt: Du platzierst deinen Finger auf der rechten Seite des Bildschirms. Bewegung: Du gleitest mit deinem Finger horizontal nach links.> Aktion: Die Reaktion auf diese Geste hängt von der Anwendung ab: - Sie kann zum nächsten Element in einem Karussell oder einem Satz von Bildern wechseln. - In einem Navigationskontext könnte sie zur vorherigen Seite zurückkehren oder die aktuelle Ansicht schließen. - Auf dem Startbildschirm wechselt sie normalerweise zum nächsten virtuellen Desktop oder Bildschirm.
Right (Nach rechts) Ausgangspunkt: Du platzierst deinen Finger auf der linken Seite des Bildschirms. Bewegung: Du gleitest mit deinem Finger horizontal nach rechts. Aktion: Ähnlich wie beim Wischen nach links, aber in die entgegengesetzte Richtung: -- Es bewegt sich oft zum vorherigen Element in einem Karussell oder einer Galerie. - Kann verwendet werden, um Seitenmenüs oder Navigationsschubladen in Apps zu öffnen. - Auf dem Startbildschirm wechselt es typischerweise zum vorherigen virtuellen Desktop.
Up (Nach oben) Ausgangspunkt: Du platzierst deinen Finger in Richtung der Unterseite des Bildschirms. Bewegung: Du gleitest mit deinem Finger nach oben in Richtung der Oberseite des Bildschirms.> Aktion: Je nach Kontext können verschiedene Aktionen auftreten: - Auf dem Startbildschirm oder in einer Liste scrollt dies normalerweise den Inhalt nach unten. - In einer Vollbild-App könnte es zusätzliche Optionen oder die App-Schublade öffnen. - Bei bestimmten Schnittstellen könnte es eine 'Aktualisieren'-Aktion auslösen oder eine Suchleiste öffnen.
`options.duration` optional	`number`	Die Dauer der Wischgeste in Millisekunden. Standard ist `1500` ms. Je niedriger der Wert, desto schneller die Wischgeste.
`options.scrollableElement` optional	`Element`	Element, innerhalb dessen gewischt wird. Wenn kein Element angegeben wird, wird für iOS der folgende Selektor verwendet `-ios predicate string:type == "XCUIElementTypeApplication"` und für Android `//android.widget.ScrollView'`. Wenn mehrere Elemente mit dem Standardselektor übereinstimmen, wird standardmäßig das erste übereinstimmende Element ausgewählt. NUR-FÜR-MOBILE-NATIVE-APPS
`options.percent` optional	`number`	Der Prozentsatz des (Standard-)scrollbaren Elements, der gewischt werden soll. Dies ist ein Wert zwischen 0 und 1. Standard ist `0.95`. NIEMALS vom exakten oberen\|unteren\|linken\|rechten Rand des Bildschirms wischen, da du zum Beispiel die Benachrichtigungsleiste oder andere Betriebssystem-/App-Funktionen auslösen könntest, was zu unerwarteten Ergebnissen führen kann. Dies hat keine Auswirkung, wenn `from` und `to` angegeben werden.
Die folgenden Werte haben NUR eine Auswirkung, wenn das `scrollableElement` NICHT angegeben ist, andernfalls werden sie ignoriert.
`options.from` optional	`object`	Die x- und y-Koordinaten des Beginns der Wischgeste. Wenn ein `scrollableElement` angegeben ist, haben diese Koordinaten keine Auswirkung.
`options.from.x` optional	`number`	Die x-Koordinate des Beginns der Wischgeste.
`options.from.y` optional	`number`	Die y-Koordinate des Beginns der Wischgeste.
`options.to` optional	`object`	Die x- und y-Koordinaten des Endes der Wischgeste. Wenn ein `scrollableElement` angegeben ist, haben diese Koordinaten keine Auswirkung.
`options.to.x` optional	`number`	Die x-Koordinate des Endes der Wischgeste.
`options.to.y` optional	`number`	Die y-Koordinate des Endes der Wischgeste.

Beispiele

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
    })
});

Parameter​

Beispiele​

Parameter

Beispiele