跳转到内容
WebView AllWebView All

能力矩阵

标记说明:

标记含义
完整由平台引擎或强类型桥完整实现。
有限制已实现,但有明确浏览器、系统或引擎限制。
不支持当前不可用,通常会抛错或按文档 no-op。
能力AndroidiOSmacOSWindowsLinuxOHOSWeb
WebViewWidget完整完整完整完整完整完整完整
原生整页缩放(setPageZoom,1.5.1+)不支持,打印说明完整完整完整完整不支持,打印说明不支持,打印说明
不创建 WebViewWidget 使用 controller完整完整完整完整完整页面操作须绑定 WebView;用户脚本可提前注册不支持,必须挂载 iframe
loadRequest GET完整完整完整完整完整完整完整
GET headers完整完整完整完整完整完整有限制,CORS/fetch
POST body完整完整完整完整完整完整有限制,CORS/fetch
POST 自定义 headers不支持完整完整完整完整不支持有限制,CORS/fetch
loadFile完整完整完整完整完整完整不支持
loadFlutterAsset完整完整完整完整完整完整完整
应用资源 URL、文件及 Range 响应支持;长度及 If-Range 回退有限制完整完整完整完整完整不支持,打印说明
应用资源持续流响应完整完整完整不支持,打印说明完整完整不支持,打印说明
loadHtmlString完整完整完整完整完整完整完整
历史前进/后退完整完整完整完整完整完整有限制,controller 维护逻辑历史
停止加载完整完整完整完整完整,含自定义请求完整取消插件请求;iframe 本身受跨域限制
历史列表查询与指定索引跳转完整完整完整完整完整完整controller 维护的逻辑历史
无 controller 清理网站数据旧版 System WebView 有限制完整完整部分类型及旧 Runtime 有限制完整支持部分类型不支持,结果会明确标记
Cookie 过期时间、Secure、HttpOnly 与 SameSite 写入完整完整完整完整完整完整仅宿主页 Cookie;不支持 HttpOnly
Cookie 属性读取新版内核支持原生属性;旧版仅名称和值完整完整完整完整仅名称和值仅名称和值
按身份删除单个 Cookie完整完整完整完整完整完整仅宿主页可见 Cookie
网页可见区域 PNG 截图完整完整完整完整完整WebView 表面不支持,打印说明
PDF 字节导出不支持,须经过系统打印流程完整完整受 Runtime 版本限制需 GTK“打印到文件”后端完整不支持
分类网站数据清理Cookie、缓存;新版支持完整类别组完整完整六种原生类别,受 Runtime 版本限制完整Cookie、可用的共享缓存不支持
原生子窗口接管相同会话;有限无痕仍共享数据相同存储,使用请求工厂相同存储,使用请求工厂相同 Profile相同存储,使用请求工厂不支持不支持
原生 window.close 通知完整完整完整完整完整不支持不支持
全屏通知及退出请求可提供独立组件iOS 16+,系统视频退出有限制macOS 13+,系统视频退出有限制完整完整完整iframe 权限及手势限制
渲染进程异常通知Android 8+,须重建可重新加载可重新加载按进程类型恢复可重新加载可重新加载不支持
能力AndroidiOSmacOSWindowsLinuxOHOSWeb
onNavigationRequest完整完整完整完整完整完整有限制
页面开始/完成完整完整完整完整完整完整iframe load 限制
进度完整完整完整完整完整完整合成 0/100
URL 变化完整完整完整完整完整完整逻辑 URL
资源错误完整完整完整完整完整完整fetch 失败可见
HTTP 错误完整完整完整完整完整完整fetch-backed load 可见
HTTP auth完整完整完整完整完整完整浏览器 iframe 不暴露
SSL auth完整完整完整完整完整完整浏览器 iframe 不暴露
能力AndroidiOSmacOSWindowsLinuxOHOSWeb
JS 开关完整完整完整完整完整完整iframe sandbox
执行 JS完整完整完整完整完整完整同源或插件管理的隔离 HTML
JS 返回值完整完整完整完整完整完整同源或隔离 bridge,且需可序列化
callAsyncJavaScript 与命名参数完整完整完整完整完整完整同源或插件管理的隔离 HTML;直接跨域 iframe 不可用
Document-start 用户脚本运行时检测完整完整完整完整完整不支持,能力检查返回 false
Document-end 用户脚本运行时检测;部分内核模拟 DOM 就绪完整完整DOM 就绪监听完整完整仅插件加载的 HTML
Promise 处理器(callHandler)运行时检测主文档主文档主文档主文档主文档同源或插件可控制的 HTML
命名独立执行环境运行时检测完整完整不支持,打印说明并跳过完整不支持,打印说明并跳过不支持,打印说明并跳过
处理器来源限制运行时检测完整完整不支持,跳过注册仅页面环境不支持,跳过注册可控制的内容中支持
JS channel完整完整完整完整完整完整同源或插件管理的隔离 HTML
Console完整完整完整完整完整完整同源或插件管理的隔离 HTML
JS dialog完整完整完整完整完整完整alert 可走 bridge;隔离 HTML 的 confirm/prompt 由浏览器处理
权限请求完整完整完整完整完整完整可控制 HTML 媒体 hook + 浏览器提示
WebAuthn/Passkey有限制,显式启用且关联应用有限制,取决于系统与 Associated Domains有限制,取决于系统与 Associated Domains有限制,取决于 Runtime/系统/凭据提供方不支持,WebKitGTK port 缺失不声明支持,ArkWeb 无公开宿主 API有限制,取决于浏览器与 iframe 策略
统一文件选择回调完整iOS 18.4+ 及兼容构建 SDK完整无统一回调,打印说明完整完整浏览器接管,打印说明
页内查找忽略大小写、循环无匹配总数无匹配总数运行时检测、循环完整,无匹配位置忽略大小写、循环同源或可控制 HTML,依赖浏览器;无总数
统一新窗口策略默认、拒绝、当前页默认、拒绝、当前页默认、拒绝、当前页默认、拒绝、当前页默认、拒绝、当前页默认、拒绝不支持,打印说明
创建时媒体手势策略完整完整完整不支持,打印说明完整完整浏览器控制,打印说明
动态媒体手势设置完整需重新创建 WebView需重新创建 WebView不支持,打印说明完整完整浏览器控制,打印说明
定位提示完整无平台 API无平台 API引擎/浏览器接管引擎/浏览器接管完整浏览器接管

注册顺序、来源策略及运行时能力检查见 JavaScript 指南。

能力AndroidiOSmacOSWindowsLinuxOHOSWeb
标题完整完整完整完整完整完整同源或插件管理的隔离 HTML
滚动位置读取完整完整不支持,打印信息并返回零完整完整完整同源或插件管理的隔离 HTML
滚动位置回调完整完整不支持,打印信息并忽略完整完整完整同源或插件管理的隔离 HTML
scrollTo/scrollBy完整完整不支持,打印信息并忽略完整完整完整同源或插件管理的隔离 HTML
滚动条完整完整不支持,打印信息并忽略CSS 实现完整CSS 实现CSS 实现
背景色完整完整macOS 12+;更早版本打印信息并忽略完整完整完整iframe CSS
缩放完整完整完整完整完整完整touch-action 限制
UA override完整完整完整完整完整完整非空 override 不支持
Overscroll完整有限制不支持,打印信息并忽略CSS 实现完整CSS 实现iframe CSS
模式AndroidiOSmacOSWindowsLinuxOHOSWeb
shared支持支持支持支持支持支持支持,需挂载 iframe
incognito有限,不隔离网站数据支持支持依赖 Runtime支持支持,无痕页面共享存储不支持
isolatedIncognito不支持支持支持依赖 Runtime支持不支持不支持

使用 WebViewSession.getCapabilities() 查询当前运行环境;不支持的创建请求会打印原因并返回 null。

Profile、网络与页面工具(1.5.x)

Section titled “Profile、网络与页面工具(1.5.x)”
能力AndroidiOSmacOSWindowsLinuxOHOSWeb
命名持久 Profile运行时 MULTI_PROFILE17+14+运行时 Profile 选项支持不支持不支持
列出/删除命名 Profile新版内核;已加载需重启删除17+,需释放原生引用14+,需释放原生引用120+,删除待浏览器进程退出支持,检查占用不支持不支持
明确关联的私密页面有限无痕,共享普通数据支持支持支持支持共享原生私密存储不支持
原生导航状态支持15+12+不支持支持有大小限制的原生状态不支持
清理原生历史支持不支持不支持支持不支持支持不支持
原生整页截图不支持不支持不支持支持支持不支持不支持
截图区域/缩放支持支持支持支持支持支持不支持
PDF 纸张/边距/方向不支持支持支持取决于 RuntimeGTK Print to File支持不支持
系统打印查询/取消任务查询/取消任务查询;取消和错误可能无法区分仅报告面板已展示查询任务查询任务同源,仅报告已请求
网页归档MHTMLWebArchiveWebArchiveMHTMLMHTMLMHTML不支持
按范围管理网站数据新版 WebView 按整个 site 组清理domain 记录domain 记录精确 origindomain 记录不支持不支持
静态内容规则仅 URL类型、站点条件、CSS 隐藏、HTTPS 升级类型、站点条件、CSS 隐藏、HTTPS 升级原生类型类型、站点条件、CSS 隐藏、HTTPS 升级仅 URL不支持
HTTP 允许/阻止/响应有限支持不支持不支持支持不支持不支持不支持
预声明自定义协议请求体受限可读取的原生请求体可读取的原生请求体创建环境时注册,仅文件/字节响应流式;请求体需 2.40+引擎初始化前注册不支持
原生菜单开关不支持不支持支持支持支持不支持不支持
静音不支持不支持不支持支持支持支持不支持
暂停媒体/暂停播放不支持15+ / 15+12+ / 12+不支持不支持仅暂停媒体不支持

范围、生命周期和引擎限制见 Profile 与页面工具 及 网络控制。