Appium-Python-Client 5.2.0__py3-none-any.whl

appium/options/ios/xcuitest/wda/use_xctestrun_file_option.py

@@ -0,0 +1,49 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+USE_XCTESTRUN_FILE = 'useXctestrunFile'
+
+
+class UseXctestrunFileOption(SupportsCapabilities):
+    @property
+    def use_xctestrun_file(self) -> Optional[bool]:
+        """
+        Whether to use of .xctestrun file to launch WDA.
+        """
+        return self.get_capability(USE_XCTESTRUN_FILE)
+
+    @use_xctestrun_file.setter
+    def use_xctestrun_file(self, value: bool) -> None:
+        """
+        Use Xctestrun file to launch WDA. It will search for such file in bootstrapPath.
+        Expected name of file is WebDriverAgentRunner_iphoneos<sdkVersion>-arm64.xctestrun for
+        real device and WebDriverAgentRunner_iphonesimulator<sdkVersion>-x86_64.xctestrun for
+        simulator. One can do build-for-testing for WebDriverAgent project for simulator and
+        real device and then you will see Product Folder like this and you need to copy content
+        of this folder at bootstrapPath location. Since this capability expects that you have
+        already built WDA project, it neither checks whether you have necessary dependencies to
+        build WDA nor will it try to build project. Defaults to false. Tips: Xcodebuild builds for the
+        target platform version. We'd recommend you to build with minimal OS version which you'd
+        like to run as the original WDA module. e.g. If you build WDA for 12.2, the module cannot
+        run on iOS 11.4 because of loading some module error on simulator. A module built with 11.4
+        can work on iOS 12.2. (This is xcodebuild's expected behaviour.)
+        """
+        self.set_capability(USE_XCTESTRUN_FILE, value)

appium/options/ios/xcuitest/wda/wait_for_idle_timeout_option.py

@@ -0,0 +1,45 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from datetime import timedelta
+from typing import Optional, Union
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+WAIT_FOR_IDLE_TIMEOUT = 'waitForIdleTimeout'
+
+
+class WaitForIdleTimeoutOption(SupportsCapabilities):
+    @property
+    def wait_for_idle_timeout(self) -> Optional[timedelta]:
+        """
+        Maximum timeout to wait until WDA responds to HTTP requests.
+        """
+        value = self.get_capability(WAIT_FOR_IDLE_TIMEOUT)
+        return None if value is None else timedelta(seconds=value)
+
+    @wait_for_idle_timeout.setter
+    def wait_for_idle_timeout(self, value: Union[timedelta, float]) -> None:
+        """
+        The time to wait until the application under test is idling.
+        XCTest requires the app's main thread to be idling in order to execute any action on it,
+        so WDA might not even start/freeze if the app under test is constantly hogging the main
+        thread. The default value is 10 (seconds). Setting it to zero disables idling checks completely
+        (not recommended) and has the same effect as setting waitForQuiescence to false.
+        Available since Appium 1.20.0.
+        """
+        self.set_capability(WAIT_FOR_IDLE_TIMEOUT, value.total_seconds() if isinstance(value, timedelta) else value)

appium/options/ios/xcuitest/wda/wait_for_quiescence_option.py

@@ -0,0 +1,42 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from datetime import timedelta
+from typing import Optional, Union
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+WAIT_FOR_QUIESCENCE = 'waitForQuiescence'
+
+
+class WaitForQuiescenceOption(SupportsCapabilities):
+    @property
+    def wait_for_quiescence(self) -> Optional[bool]:
+        """
+        Whether to wait for application quiescence.
+        """
+        return self.get_capability(WAIT_FOR_QUIESCENCE)
+
+    @wait_for_quiescence.setter
+    def wait_for_quiescence(self, value: Union[timedelta, float]) -> None:
+        """
+        It allows to turn on/off waiting for application quiescence in WebDriverAgent,
+        while performing queries. The default value is true. You can avoid this kind
+        of issues if you turn it off. Consider using waitForIdleTimeout capability
+        instead for this purpose since Appium 1.20.0.
+        """
+        self.set_capability(WAIT_FOR_QUIESCENCE, value)

appium/options/ios/xcuitest/wda/wda_base_url_option.py

@@ -0,0 +1,41 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+WDA_BASE_URL = 'wdaBaseUrl'
+
+
+class WdaBaseUrlOption(SupportsCapabilities):
+    @property
+    def wda_base_url(self) -> Optional[str]:
+        """
+        Prefix to build a custom WebDriverAgent URL.
+        """
+        return self.get_capability(WDA_BASE_URL)
+
+    @wda_base_url.setter
+    def wda_base_url(self, value: str) -> None:
+        """
+        This value, if specified, will be used as a prefix to build a custom
+        WebDriverAgent url. It is different from webDriverAgentUrl, because
+        if the latter is set then it expects WebDriverAgent to be already
+        listening and skips the building phase. Defaults to http://localhost.
+        """
+        self.set_capability(WDA_BASE_URL, value)

appium/options/ios/xcuitest/wda/wda_connection_timeout_option.py

@@ -0,0 +1,43 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from datetime import timedelta
+from typing import Optional, Union
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+WDA_CONNECTION_TIMEOUT = 'wdaConnectionTimeout'
+
+
+class WdaConnectionTimeoutOption(SupportsCapabilities):
+    @property
+    def wda_connection_timeout(self) -> Optional[timedelta]:
+        """
+        Maximum timeout to wait until WDA responds to HTTP requests.
+        """
+        value = self.get_capability(WDA_CONNECTION_TIMEOUT)
+        return None if value is None else timedelta(milliseconds=value)
+
+    @wda_connection_timeout.setter
+    def wda_connection_timeout(self, value: Union[timedelta, int]) -> None:
+        """
+        Connection timeout to wait for a response from WebDriverAgent.
+        Defaults to 240000ms.
+        """
+        self.set_capability(
+            WDA_CONNECTION_TIMEOUT, int(value.total_seconds() * 1000) if isinstance(value, timedelta) else value
+        )

appium/options/ios/xcuitest/wda/wda_eventloop_idle_delay_option.py

@@ -0,0 +1,46 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from datetime import timedelta
+from typing import Optional, Union
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+WDA_EVENTLOOP_IDLE_DELAY = 'wdaEventloopIdleDelay'
+
+
+class WdaEventloopIdleDelayOption(SupportsCapabilities):
+    @property
+    def wda_eventloop_idle_delay(self) -> Optional[timedelta]:
+        """
+        Event loop idle delay.
+        """
+        value = self.get_capability(WDA_EVENTLOOP_IDLE_DELAY)
+        return None if value is None else timedelta(seconds=value)
+
+    @wda_eventloop_idle_delay.setter
+    def wda_eventloop_idle_delay(self, value: Union[timedelta, float]) -> None:
+        """
+        Delays the invocation of -[XCUIApplicationProcess setEventLoopHasIdled:] by the
+        duration specified with this capability. This can help quiescence apps
+        that fail to do so for no obvious reason (and creating a session fails for
+        that reason). This increases the time for session creation
+        because -[XCUIApplicationProcess setEventLoopHasIdled:] is called multiple times.
+        If you enable this capability start with at least 3 seconds and try increasing it,
+        if creating the session still fails. Defaults to 0.
+        """
+        self.set_capability(WDA_EVENTLOOP_IDLE_DELAY, value.total_seconds() if isinstance(value, timedelta) else value)

appium/options/ios/xcuitest/wda/wda_launch_timeout_option.py

@@ -0,0 +1,41 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from datetime import timedelta
+from typing import Optional, Union
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+WDA_LAUNCH_TIMEOUT = 'wdaLaunchTimeout'
+
+
+class WdaLaunchTimeoutOption(SupportsCapabilities):
+    @property
+    def wda_launch_timeout(self) -> Optional[timedelta]:
+        """
+        Maximum timeout to wait until WDA is listening.
+        """
+        value = self.get_capability(WDA_LAUNCH_TIMEOUT)
+        return None if value is None else timedelta(milliseconds=value)
+
+    @wda_launch_timeout.setter
+    def wda_launch_timeout(self, value: Union[timedelta, int]) -> None:
+        """
+        Timeout to wait for WebDriverAgent to be pingable,
+        after its building is finished. Defaults to 60000ms.
+        """
+        self.set_capability(WDA_LAUNCH_TIMEOUT, int(value.total_seconds() * 1000) if isinstance(value, timedelta) else value)

appium/options/ios/xcuitest/wda/wda_local_port_option.py

@@ -0,0 +1,41 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+WDA_LOCAL_PORT = 'wdaLocalPort'
+
+
+class WdaLocalPortOption(SupportsCapabilities):
+    @property
+    def wda_local_port(self) -> Optional[int]:
+        """
+        Local port number where the WDA traffic is being forwarded.
+        """
+        return self.get_capability(WDA_LOCAL_PORT)
+
+    @wda_local_port.setter
+    def wda_local_port(self, value: int) -> None:
+        """
+        This value, if specified, will be used to forward traffic from
+        Mac host to real ios devices over USB.
+        Default value is the same as the port number used by WDA on
+        the device under test (8100).
+        """
+        self.set_capability(WDA_LOCAL_PORT, value)

appium/options/ios/xcuitest/wda/wda_startup_retries_option.py

@@ -0,0 +1,39 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+WDA_STARTUP_RETRIES = 'wdaStartupRetries'
+
+
+class WdaStartupRetriesOption(SupportsCapabilities):
+    @property
+    def wda_startup_retries(self) -> Optional[int]:
+        """
+        Number of retries before to fail WDA deployment.
+        """
+        return self.get_capability(WDA_STARTUP_RETRIES)
+
+    @wda_startup_retries.setter
+    def wda_startup_retries(self, value: int) -> None:
+        """
+        Number of times to try to build and launch WebDriverAgent onto the device.
+        Defaults to 2.
+        """
+        self.set_capability(WDA_STARTUP_RETRIES, value)

appium/options/ios/xcuitest/wda/wda_startup_retry_interval_option.py

@@ -0,0 +1,43 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from datetime import timedelta
+from typing import Optional, Union
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+WDA_STARTUP_RETRY_INTERVAL = 'wdaStartupRetryInterval'
+
+
+class WdaStartupRetryIntervalOption(SupportsCapabilities):
+    @property
+    def wda_startup_retry_interval(self) -> Optional[timedelta]:
+        """
+        Interval to wait between tries to build and launch WebDriverAgent.
+        """
+        value = self.get_capability(WDA_STARTUP_RETRY_INTERVAL)
+        return None if value is None else timedelta(milliseconds=value)
+
+    @wda_startup_retry_interval.setter
+    def wda_startup_retry_interval(self, value: Union[timedelta, int]) -> None:
+        """
+        Time interval to wait between tries to build and launch WebDriverAgent.
+        Defaults to 10000ms.
+        """
+        self.set_capability(
+            WDA_STARTUP_RETRY_INTERVAL, int(value.total_seconds() * 1000) if isinstance(value, timedelta) else value
+        )

appium/options/ios/xcuitest/wda/web_driver_agent_url_option.py

@@ -0,0 +1,39 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+WEB_DRIVER_AGENT_URL = 'webDriverAgentUrl'
+
+
+class WebDriverAgentUrlOption(SupportsCapabilities):
+    @property
+    def web_driver_agent_url(self) -> Optional[str]:
+        """
+        WedDriverAgent URL.
+        """
+        return self.get_capability(WEB_DRIVER_AGENT_URL)
+
+    @web_driver_agent_url.setter
+    def web_driver_agent_url(self, value: str) -> None:
+        """
+        If provided, Appium will connect to an existing WebDriverAgent
+        instance at this URL instead of starting a new one.
+        """
+        self.set_capability(WEB_DRIVER_AGENT_URL, value)

appium/options/ios/xcuitest/wda/xcode_org_id_option.py

@@ -0,0 +1,39 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+XCODE_ORG_ID = 'xcodeOrgId'
+
+
+class XcodeOrgIdOption(SupportsCapabilities):
+    @property
+    def xcode_org_id(self) -> Optional[str]:
+        """
+        Signing certificate organization id for WebDriverAgent compilation.
+        """
+        return self.get_capability(XCODE_ORG_ID)
+
+    @xcode_org_id.setter
+    def xcode_org_id(self, value: str) -> None:
+        """
+        Provides a signing certificate organization id for WebDriverAgent compilation.
+        If signing id is not provided then it defaults to "iPhone Developer"
+        """
+        self.set_capability(XCODE_ORG_ID, value)

appium/options/ios/xcuitest/wda/xcode_signing_id_option.py

@@ -0,0 +1,39 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+XCODE_SIGNING_ID = 'xcodeSigningId'
+
+
+class XcodeSigningIdOption(SupportsCapabilities):
+    @property
+    def xcode_signing_id(self) -> Optional[str]:
+        """
+        Signing certificate for WebDriverAgent compilation.
+        """
+        return self.get_capability(XCODE_SIGNING_ID)
+
+    @xcode_signing_id.setter
+    def xcode_signing_id(self, value: str) -> None:
+        """
+        Provides a signing certificate for WebDriverAgent compilation.
+        If signing id is not provided then it defaults to "iPhone Developer"
+        """
+        self.set_capability(XCODE_SIGNING_ID, value)

appium/options/ios/xcuitest/webview/absolute_web_locations_option.py

@@ -0,0 +1,42 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+ABSOLUTE_WEB_LOCATIONS = 'absoluteWebLocations'
+
+
+class AbsoluteWebLocationsOption(SupportsCapabilities):
+    @property
+    def absolute_web_locations(self) -> Optional[bool]:
+        """
+        Whether Get Element Location returns coordinates
+        relative to the page origin for web view elements.
+        """
+        return self.get_capability(ABSOLUTE_WEB_LOCATIONS)
+
+    @absolute_web_locations.setter
+    def absolute_web_locations(self, value: bool) -> None:
+        """
+        This capability will direct the Get Element Location command, when used
+        within webviews, to return coordinates which are relative to the origin of
+        the page, rather than relative to the current scroll offset. This capability
+        has no effect outside of webviews. Defaults to  false.
+        """
+        self.set_capability(ABSOLUTE_WEB_LOCATIONS, value)

appium/options/ios/xcuitest/webview/additional_webview_bundle_ids_option.py

@@ -0,0 +1,40 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import List, Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+ADDITIONAL_WEBVIEW_BUNDLE_IDS = 'additionalWebviewBundleIds'
+
+
+class AdditionalWebviewBundleIdsOption(SupportsCapabilities):
+    @property
+    def additional_webview_bundle_ids(self) -> Optional[List[str]]:
+        """
+        Array of possible bundle identifiers for webviews.
+        """
+        return self.get_capability(ADDITIONAL_WEBVIEW_BUNDLE_IDS)
+
+    @additional_webview_bundle_ids.setter
+    def additional_webview_bundle_ids(self, value: List[str]) -> None:
+        """
+        Array of possible bundle identifiers for webviews. This is sometimes
+        necessary if the Web Inspector is found to be returning a modified
+        bundle identifier for the app. Defaults to [].
+        """
+        self.set_capability(ADDITIONAL_WEBVIEW_BUNDLE_IDS, value)