能力矩阵
标记说明:
| 标记 | 含义 |
|---|---|
| 完整 | 由平台引擎或强类型桥完整实现。 |
| 有限制 | 已实现,但有明确浏览器、系统或引擎限制。 |
| 不支持 | 当前不可用,通常会抛错或按文档 no-op。 |
| 能力 | Android | iOS | macOS | Windows | Linux | OHOS | Web |
|---|---|---|---|---|---|---|---|
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+,须重建 | 可重新加载 | 可重新加载 | 按进程类型恢复 | 可重新加载 | 可重新加载 | 不支持 |
| 能力 | Android | iOS | macOS | Windows | Linux | OHOS | Web |
|---|---|---|---|---|---|---|---|
onNavigationRequest | 完整 | 完整 | 完整 | 完整 | 完整 | 完整 | 有限制 |
| 页面开始/完成 | 完整 | 完整 | 完整 | 完整 | 完整 | 完整 | iframe load 限制 |
| 进度 | 完整 | 完整 | 完整 | 完整 | 完整 | 完整 | 合成 0/100 |
| URL 变化 | 完整 | 完整 | 完整 | 完整 | 完整 | 完整 | 逻辑 URL |
| 资源错误 | 完整 | 完整 | 完整 | 完整 | 完整 | 完整 | fetch 失败可见 |
| HTTP 错误 | 完整 | 完整 | 完整 | 完整 | 完整 | 完整 | fetch-backed load 可见 |
| HTTP auth | 完整 | 完整 | 完整 | 完整 | 完整 | 完整 | 浏览器 iframe 不暴露 |
| SSL auth | 完整 | 完整 | 完整 | 完整 | 完整 | 完整 | 浏览器 iframe 不暴露 |
JavaScript、UI 和权限
Section titled “JavaScript、UI 和权限”| 能力 | Android | iOS | macOS | Windows | Linux | OHOS | Web |
|---|---|---|---|---|---|---|---|
| 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 指南。
| 能力 | Android | iOS | macOS | Windows | Linux | OHOS | Web |
|---|---|---|---|---|---|---|---|
| 标题 | 完整 | 完整 | 完整 | 完整 | 完整 | 完整 | 同源或插件管理的隔离 HTML |
| 滚动位置读取 | 完整 | 完整 | 不支持,打印信息并返回零 | 完整 | 完整 | 完整 | 同源或插件管理的隔离 HTML |
| 滚动位置回调 | 完整 | 完整 | 不支持,打印信息并忽略 | 完整 | 完整 | 完整 | 同源或插件管理的隔离 HTML |
scrollTo/scrollBy | 完整 | 完整 | 不支持,打印信息并忽略 | 完整 | 完整 | 完整 | 同源或插件管理的隔离 HTML |
| 滚动条 | 完整 | 完整 | 不支持,打印信息并忽略 | CSS 实现 | 完整 | CSS 实现 | CSS 实现 |
| 背景色 | 完整 | 完整 | macOS 12+;更早版本打印信息并忽略 | 完整 | 完整 | 完整 | iframe CSS |
| 缩放 | 完整 | 完整 | 完整 | 完整 | 完整 | 完整 | touch-action 限制 |
| UA override | 完整 | 完整 | 完整 | 完整 | 完整 | 完整 | 非空 override 不支持 |
| Overscroll | 完整 | 有限制 | 不支持,打印信息并忽略 | CSS 实现 | 完整 | CSS 实现 | iframe CSS |
会话模式(1.4.9)
Section titled “会话模式(1.4.9)”| 模式 | Android | iOS | macOS | Windows | Linux | OHOS | Web |
|---|---|---|---|---|---|---|---|
shared | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持,需挂载 iframe |
incognito | 有限,不隔离网站数据 | 支持 | 支持 | 依赖 Runtime | 支持 | 支持,无痕页面共享存储 | 不支持 |
isolatedIncognito | 不支持 | 支持 | 支持 | 依赖 Runtime | 支持 | 不支持 | 不支持 |
使用 WebViewSession.getCapabilities() 查询当前运行环境;不支持的创建请求会打印原因并返回 null。
Profile、网络与页面工具(1.5.x)
Section titled “Profile、网络与页面工具(1.5.x)”| 能力 | Android | iOS | macOS | Windows | Linux | OHOS | Web |
|---|---|---|---|---|---|---|---|
| 命名持久 Profile | 运行时 MULTI_PROFILE | 17+ | 14+ | 运行时 Profile 选项 | 支持 | 不支持 | 不支持 |
| 列出/删除命名 Profile | 新版内核;已加载需重启删除 | 17+,需释放原生引用 | 14+,需释放原生引用 | 120+,删除待浏览器进程退出 | 支持,检查占用 | 不支持 | 不支持 |
| 明确关联的私密页面 | 有限无痕,共享普通数据 | 支持 | 支持 | 支持 | 支持 | 共享原生私密存储 | 不支持 |
| 原生导航状态 | 支持 | 15+ | 12+ | 不支持 | 支持 | 有大小限制的原生状态 | 不支持 |
| 清理原生历史 | 支持 | 不支持 | 不支持 | 支持 | 不支持 | 支持 | 不支持 |
| 原生整页截图 | 不支持 | 不支持 | 不支持 | 支持 | 支持 | 不支持 | 不支持 |
| 截图区域/缩放 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 不支持 |
| PDF 纸张/边距/方向 | 不支持 | 支持 | 支持 | 取决于 Runtime | GTK Print to File | 支持 | 不支持 |
| 系统打印 | 查询/取消任务 | 查询/取消任务 | 查询;取消和错误可能无法区分 | 仅报告面板已展示 | 查询任务 | 查询任务 | 同源,仅报告已请求 |
| 网页归档 | MHTML | WebArchive | WebArchive | MHTML | MHTML | MHTML | 不支持 |
| 按范围管理网站数据 | 新版 WebView 按整个 site 组清理 | domain 记录 | domain 记录 | 精确 origin | domain 记录 | 不支持 | 不支持 |
| 静态内容规则 | 仅 URL | 类型、站点条件、CSS 隐藏、HTTPS 升级 | 类型、站点条件、CSS 隐藏、HTTPS 升级 | 原生类型 | 类型、站点条件、CSS 隐藏、HTTPS 升级 | 仅 URL | 不支持 |
| HTTP 允许/阻止/响应 | 有限支持 | 不支持 | 不支持 | 支持 | 不支持 | 不支持 | 不支持 |
| 预声明自定义协议 | 请求体受限 | 可读取的原生请求体 | 可读取的原生请求体 | 创建环境时注册,仅文件/字节响应 | 流式;请求体需 2.40+ | 引擎初始化前注册 | 不支持 |
| 原生菜单开关 | 不支持 | 不支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| 静音 | 不支持 | 不支持 | 不支持 | 支持 | 支持 | 支持 | 不支持 |
| 暂停媒体/暂停播放 | 不支持 | 15+ / 15+ | 12+ / 12+ | 不支持 | 不支持 | 仅暂停媒体 | 不支持 |
范围、生命周期和引擎限制见 Profile 与页面工具 及 网络控制。