Aller au contenu principal

longPress

Effectue un geste d'appui prolongé sur l'élément donné à l'écran.

Cela émet une commande WebDriver action pour l'élément sélectionné. Elle est basée sur la commande click.

info

Cette commande ne fonctionne qu'avec les composants à jour suivants :

  • Serveur Appium (version 2.0.0 ou supérieure)
  • appium-uiautomator2-driver (pour Android)
  • appium-xcuitest-driver (pour iOS)

Assurez-vous que votre environnement Appium local ou basé sur le cloud est régulièrement mis à jour pour éviter les problèmes de compatibilité.

Utilisation
$(selector).longPress({ x, y, duration })
Paramètres
NomTypeDétails
options
optionnel
LongPressOptionsOptions d'appui prolongé (optionnel)
options.x
optionnel
numberNombre (optionnel)
options.y
optionnel
numberNombre (optionnel)
options.duration
optionnel
numberDurée de l'appui en ms, par défaut 1500 ms
MOBILE UNIQUEMENT
Exemples
longpress.offset.js
it('should demonstrate a longPress using an offset on the iOS Contacts icon', async () => {
const contacts = $('~Contacts')
// opens the Contacts menu on iOS where you can quickly create
// a new contact, edit your home screen, or remove the app
// clicks 30 horizontal and 10 vertical pixels away from location of the icon (from center point of element)
await contacts.longPress({ x: 30, y: 10 })
})

longpress.example.js
it('should be able to open the contacts menu on iOS by executing a longPress of 5 seconds', async () => {
const contacts = $('~Contacts')
// opens the Contacts menu on iOS where you can quickly create
// a new contact, edit your home screen, or remove the app
await contacts.longPress({ duration: 5 * 1000 })
})

Welcome! How can I help?

WebdriverIO AI Copilot