io.appium.java_client.ios.options.wda

Interface SupportsUseNewWdaOption<T extends BaseOptions<T>>

All Superinterfaces:

CanSetCapability<T>, org.openqa.selenium.Capabilities, java.io.Serializable

All Known Implementing Classes:

XCUITestOptions

public interface SupportsUseNewWdaOption<T extends BaseOptions<T>>
extends org.openqa.selenium.Capabilities, CanSetCapability<T>

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	USE_NEW_WDA_OPTION

Method Summary

Modifier and Type	Method and Description
default java.util.Optional<java.lang.Boolean>	doesUseNewWDA() Get whether to uninstall of any existing WebDriverAgent app on the device under test.
default T	setUseNewWDA(boolean value) If true, forces uninstall of any existing WebDriverAgent app on device.
default T	useNewWDA() Enforce uninstall of any existing WebDriverAgent app on the device under test.

Methods inherited from interface org.openqa.selenium.Capabilities

asMap, getBrowserName, getBrowserVersion, getCapability, getCapabilityNames, getPlatformName, is, merge

Methods inherited from interface io.appium.java_client.remote.options.CanSetCapability

amend, setCapability

Field Detail

USE_NEW_WDA_OPTION

static final java.lang.String USE_NEW_WDA_OPTION

See Also:

Constant Field Values

Method Detail

useNewWDA

default T useNewWDA()

Enforce uninstall of any existing WebDriverAgent app on the device under test.

Returns:

self instance for chaining.

setUseNewWDA

default T setUseNewWDA(boolean value)

If true, forces uninstall of any existing WebDriverAgent app on device. Set it to true if you want to apply different startup options for WebDriverAgent for each session. Although, it is only guaranteed to work stable on Simulator. Real devices require WebDriverAgent client to run for as long as possible without reinstall/restart to avoid issues like https://github.com/facebook/WebDriverAgent/issues/507. The false value (the default behaviour since driver version 2.35.0) will try to detect currently running WDA listener executed by previous testing session(s) and reuse it if possible, which is highly recommended for real device testing and to speed up suites of multiple tests in general. A new WDA session will be triggered at the default URL (http://localhost:8100) if WDA is not listening and webDriverAgentUrl capability is not set. The negative/unset value of useNewWDA capability has no effect prior to xcuitest driver version 2.35.0.

Parameters:

value - Whether to force uninstall of any existing WebDriverAgent app on device.

Returns:

self instance for chaining.

doesUseNewWDA

default java.util.Optional<java.lang.Boolean> doesUseNewWDA()

Get whether to uninstall of any existing WebDriverAgent app on the device under test.

Returns:

True or false.