Resolve app WebView automation issues

Learn about possible solutions if you face issues using Android app WebView automation on BrowserStack App Automate.

Issues

When you run tests on BrowserStack App Automate, you may encounter the following app WebView automation issues while using Android devices on BrowserStack:

App is unable to retrieve the WebView context
After switching to the WebView context, your app is unable to interact with the loaded elements
WebView pages of the app fail to load

Causes

Some of the common reasons for this issue are:

App WebView automation is tested locally using simulators and not real devices
Appium version or protocol mismatch between your local setup and BrowserStack
setWebContentsDebuggingEnabled property is not enabled for WebViews in your app
Test script is not optimized to work with the ChromeDriver 89 or higher supported by BrowserStack
WebView timeout set is less than the time it takes to get WebView context

Resolutions

Ensure that your WebView automation runs on the app locally using real mobile devices. BrowserStack App Automate only provides real mobile devices; thus your testing experience with real mobile devices locally can be comparable with BrowserStack.
Ensure that your local Appium sessions and BrowserStack Appium sessions are running on the same Appium protocol(W3C or MJSONWP) and Appium version. Check out BrowserStack - Capabilities for running mobile app tests to learn about the specific Appium protocol & Appium version on BrowserStack App Automate.
Ensure that the setWebContentsDebuggingEnabled property is enabled for WebViews in your app. This property enables debugging of web contents loaded in the WebView of your app. Check out WebView documentation for more information.
If you are testing a hybrid app built using frameworks such as Ionic, Cordova, etc., you can launch your app in the WebView context by setting the autoWebView capability to true in your Appium sessions. Check out the following resources to learn more about this capability:
- Desired Capabilities - Appium
- Automating hybrid apps
BrowserStack Android devices support ChromeDriver 89 or higher. From ChromeDriver 89 onwards, your Appium scripts need to find the correct WebView window to interact with WebView elements and switch to it using the driver.switchTo().window(handle) command. Check out handling multiple WebViews to learn more about multiple WebViews.
Occasionally the time taken for the WebView context to be active might be longer, causing your tests to fail. You can increase this timeout using autoWebViewTimeout Appium capability. Check out Desired Capabilities - Appium to learn more about this capability.