Playwright Android中webview.page()无法解析的原因及解决办法

你已经成功获取了WebView对象，但调用webview.page()始终无法解析，结合你的测试环境（Pixel 7 Pro API UpsideDownCake arm64），可以从以下几个方向排查解决：

1. 等待WebView完成初始化/页面加载 #

WebView对象获取到后，可能页面还未完成加载，直接调用page()会失败。可以先等待WebView的导航完成或页面加载状态：

// 方案1：等待导航事件触发
await webview.waitForNavigation();
const page = await webview.page();

// 方案2：等待页面加载完成
await webview.waitForFunction('document.readyState === "complete"');
const page = await webview.page();

2. 确认App已开启WebView调试模式 #

Android系统要求WebView必须启用调试模式，Playwright才能与之交互获取Page对象。需要在你的App代码中添加调试开关：

// 在Application或Activity的初始化代码中添加
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
    WebView.setWebContentsDebuggingEnabled(true);
}

注意：正式发布的App请关闭该开关，仅在测试环境启用。

3. 升级Playwright到最新版本 #

Android 14（UpsideDownCake）是较新的系统版本，旧版Playwright可能存在兼容性问题。执行以下命令升级：

npm install @playwright/test@latest
npx playwright install

4. 确认WebView进程匹配正确 #

可能存在多个WebView进程，你指定的pkg参数没有匹配到正确的目标进程。可以先列出所有可用WebView进程，确认信息后再调用：

const allWebViews = await device.webViews();
console.log('所有WebView进程信息:', allWebViews);
// 根据输出的正确包名/进程名重新获取WebView
const webview = await device.webView({ pkg: '正确的包名', proc: '对应的进程名' });
const page = await webview.page();

5. 检查ADB连接与设备权限 #

确保ADB连接正常，设备已授予调试权限：

# 重启ADB服务
adb kill-server
adb start-server
# 确认设备连接状态
adb devices

同时检查设备是否开启了USB调试（或无线调试），以及是否允许当前电脑的调试连接。

内容的提问来源于stack exchange，提问作者Iman Mohamadi