zoom

Performs a zoom gesture on the given element on the screen.

info

Zooming is done based on native mobile gestures. It is only supported for the following drivers:

• appium-uiautomator2-driver for Android
• appium-xcuitest-driver for iOS

Usage

browser.zoom({ duration, scale })

Parameters

Name	Type	Details
options optional	PinchAndZoomOptions	Zoom options (optional)
options.duration optional	number	The duration in millisecond of how fast the zoom should be executed, minimal is 500 ms and max is 10000 ms. The default is 1500 ms (1.5 seconds) (optional)
options.scale optional	number	The scale of how big the zoom should be according to the screen. Valid values must be float numbers in range 0..1, where 1.0 is 100% (optional)

Example

zoom.js

it('should demonstrate a zoom on Google maps', async () => {
    const mapsElement = $('//*[@resource-id="com.google.android.apps.maps:id/map_frame"]')
    // Zoom with the default duration scale
    await mapsElement.zoom()
    // Zoom with a custom duration and scale
    await mapsElement.zoom({ duration: 4000, scale: 0.9 })
})