跳转到内容
WebView AllWebView All
这是 1.4.x 版本的文档,最新接口请切换至 latest。

能力矩阵

标记说明:

标记含义
完整由平台引擎或强类型桥完整实现。
有限制已实现,但有明确浏览器、系统或引擎限制。
不支持当前不可用,通常会抛错或按文档 no-op。
能力AndroidiOSmacOSWindowsLinuxOHOSWeb
WebViewWidget完整完整完整完整完整完整完整
不创建 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 维护逻辑历史
无 controller 清理网站数据旧版 System WebView 有限制完整完整部分类型及旧 Runtime 有限制完整支持部分类型不支持,结果会明确标记
能力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
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 策略
文件选择完整无通用回调无通用回调无通用回调无通用回调完整浏览器接管
定位提示完整无平台 API无平台 API引擎/浏览器接管引擎/浏览器接管完整浏览器接管
能力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。