longPress

Performs a long press gesture on the given element on the screen.

This issues a WebDriver action command for the selected element. It is based on the click command.

Usage

$(selector).longPress({ x, y, duration })

Parameters

Name	Type	Details
options optional	LongPressOptions	Long press options (optional)
options.x optional	number	Number (optional)
options.y optional	number	Number (optional)
options.duration optional	number	Duration of the press in ms, default is 1500 ms MOBILE-ONLY

Examples

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