zoom

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

정보

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

This command only works with the following up-to-date components:

• Appium server (version 2.0.0 or higher)
• appium-uiautomator2-driver (for Android)
• appium-xcuitest-driver (for iOS)

Make sure your local or cloud-based Appium environment is regularly updated to avoid compatibility issues.

Usage

$(selector).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 })
})