Capability Matrix
Legend:
| Mark | Meaning |
|---|---|
| Full | Implemented by the platform engine or a typed bridge. |
| Limited | Implemented with documented engine, browser, or OS constraints. |
| No | Not available and expected to throw or no-op as documented. |
Core WebView API
Section titled “Core WebView API”| Feature | Android | iOS | macOS | Windows | Linux | OHOS | Web |
|---|---|---|---|---|---|---|---|
WebViewWidget | Full | Full | Full | Full | Full | Full | Full |
Controller use without WebViewWidget | Full | Full | Full | Full | Full | Page operations require an attached WebView; user scripts can be registered earlier | No, iframe must be attached |
loadRequest GET | Full | Full | Full | Full | Full | Full | Full |
loadRequest GET headers | Full | Full | Full | Full | Full | Full | Limited, CORS/fetch |
loadRequest POST body | Full | Full | Full | Full | Full | Full | Limited, CORS/fetch |
loadRequest POST headers | No | Full | Full | Full | Full | No | Limited, CORS/fetch |
loadFile | Full | Full | Full | Full | Full | Full | No |
loadFlutterAsset | Full | Full | Full | Full | Full | Full | Full |
| Application resource URLs, files and ranges | Supported; length and If-Range limits | Full | Full | Full | Full | Full | Unsupported; logs a diagnostic |
| Incremental application resource streams | Full | Full | Full | Unsupported; logs a diagnostic | Full | Full | Unsupported; logs a diagnostic |
loadHtmlString | Full | Full | Full | Full | Full | Full | Full |
currentUrl | Full | Full | Full | Full | Full | Full | Limited, logical URL for synthetic loads |
| History back/forward | Full | Full | Full | Full | Full | Full | Limited, controller-managed history |
reload | Full | Full | Full | Full | Full | Full | Limited, reloads last controller load |
clearCache | Full | Full | Full | Full | Full | Full | Limited, host-origin cache storage |
clearLocalStorage | Full | Full | Full | Full | Full | Full | Limited, host-origin storage |
| Controller-independent website-data clearing | Limited on older System WebView | Full | Full | Limited categories and older runtimes | Full | Limited categories | No, reports unsupported |
Navigation and Errors
Section titled “Navigation and Errors”| Feature | Android | iOS | macOS | Windows | Linux | OHOS | Web |
|---|---|---|---|---|---|---|---|
onNavigationRequest | Full | Full | Full | Full | Full | Full | Limited, controller loads and observable iframe loads |
onPageStarted/onPageFinished | Full | Full | Full | Full | Full | Full | Limited, iframe load events |
onProgress | Full | Full | Full | Full | Full | Full | Limited, synthetic 0/100 plus load event |
onUrlChange | Full | Full | Full | Full | Full | Full | Limited, logical URL where needed |
onTitleChange | Full | Full | Full | Full | Full | Full | Same-origin or managed isolated HTML |
onWebResourceError | Full | Full | Full | Full | Full | Full | Limited, fetch failures only for custom request path |
onHttpError | Full | Full | Full | Full | Full | Full | Limited, fetch-backed loads expose response |
| HTTP auth callback | Full | Full | Full | Full | Full | Full | No browser iframe event |
| Recoverable SSL auth callback | Full | Full | Full | Full | Full | Full | No browser iframe event |
JavaScript, UI, and Permissions
Section titled “JavaScript, UI, and Permissions”| Feature | Android | iOS | macOS | Windows | Linux | OHOS | Web |
|---|---|---|---|---|---|---|---|
| JavaScript enable/disable | Full | Full | Full | Full | Full | Full | Limited, iframe sandbox |
runJavaScript | Full | Full | Full | Full | Full | Full | Same-origin or managed isolated HTML |
runJavaScriptReturningResult | Full | Full | Full | Full | Full | Full | Same-origin or managed isolated HTML; JSON-serializable |
callAsyncJavaScript with named arguments | Full | Full | Full | Full | Full | Full | Same-origin or managed isolated HTML; cross-origin iframe unavailable |
| Document-start user scripts | Runtime capability | Full | Full | Full | Full | Full | No, capability returns false |
| JavaScript channels | Full | Full | Full | Full | Full | Full | Same-origin or managed isolated HTML |
| Console message callback | Full | Full | Full | Full | Full | Full | Same-origin or managed isolated HTML |
alert callback | Full | Full | Full | Full | Full | Full | Same-origin or managed isolated HTML |
confirm callback | Full | Full | Full | Full | Full | Full | Same-origin synchronous callback; isolated uses browser dialog |
prompt callback | Full | Full | Full | Full | Full | Full | Same-origin synchronous callback; isolated uses browser dialog |
| Permission request callback | Full | Full | Full | Full | Full | Full | Controllable HTML media hook plus browser prompt |
| WebAuthn/passkeys | Limited, explicit opt-in and app association | Limited, OS and Associated Domains | Limited, OS and Associated Domains | Limited, Runtime/OS/provider | No, WebKitGTK port | Not claimed; no documented ArkWeb host API | Limited, browser and iframe policy |
| File selector callback | Full | No common callback | No common callback | No common callback | No common callback | Full | Browser-owned |
| Geolocation prompt callback | Full | No platform API | No platform API | Browser/engine-owned | Browser/engine-owned | Full | Browser-owned |
| Fullscreen custom widget | Full | Engine-owned | Engine-owned | Engine-owned | Engine-owned | Full | Browser-owned |
View State and Styling
Section titled “View State and Styling”| Feature | Android | iOS | macOS | Windows | Linux | OHOS | Web |
|---|---|---|---|---|---|---|---|
getTitle | Full | Full | Full | Full | Full | Full | Same-origin or managed isolated HTML |
| Scroll position read | Full | Full | No, logs and returns zero | Full | Full | Full | Same-origin or managed isolated HTML |
| Scroll position callback | Full | Full | No, logs and no-op | Full | Full | Full | Same-origin or managed isolated HTML |
scrollTo/scrollBy | Full | Full | No, logs and no-op | Full | Full | Full | Same-origin or managed isolated HTML |
| Scrollbar visibility | Full | Full | No, logs and no-op | Full, CSS injection | Full | Full, CSS injection | Full, CSS injection |
| Background color | Full | Full | macOS 12+, logs and no-op earlier | Full | Full | Full | Full, iframe CSS |
| Zoom enable/disable | Full | Full | Full | Full | Full | Full | Limited, iframe touch action |
| User agent override | Full | Full | Full | Full | Full | Full | No; logs and ignores non-null override |
| Overscroll mode | Full | Limited | No, logs and no-op | Full, CSS injection | Full | Full, CSS injection | Full, iframe CSS |
Platform API Highlights
Section titled “Platform API Highlights”| Platform | Important extra APIs |
|---|---|
| Android | debugging, media gesture, text zoom, wide viewport, content/file access, geolocation, file selector, custom fullscreen widget, console, JavaScript dialogs, scrollbars, overscroll, mixed content, WebAuthn/passkeys, Payment Request, insets. |
| iOS/macOS | inline media, media gesture policy, app-bound domains, JavaScript popup policy, back/forward gestures, link preview, inspectable, WebKit file read access, permission prompt forwarding. |
| Windows | WebView2 environment, runtime version, popup policy, DevTools, suspend/resume, zoom factor, cache disabled, virtual host mapping, extended cookies. |
| Linux | WebKitGTK developer extras, inspector, media settings, page cache, file URL access, font sizes, zoom factor, JavaScript dialogs, HTTP/SSL auth, permission requests. |
| OHOS | ArkWeb settings, debugging, file selector, geolocation prompts, custom fullscreen widget, third-party cookies, OHOS permission resource types. |
| Web | iframe attributes, sandbox/referrer/permissions policy, fetch-backed requests, isolated managed-HTML bridge, media permission mediation. |
Session modes (1.4.9)
Section titled “Session modes (1.4.9)”| Mode | Android | iOS | macOS | Windows | Linux | OHOS | Web |
|---|---|---|---|---|---|---|---|
shared | Full | Full | Full | Full | Full | Full | Full, iframe must be attached |
incognito | Limited, shared website data | Full | Full | Runtime capability | Full | Shared native private store | No |
isolatedIncognito | No | Full | Full | Runtime capability | Full | No | No |
Query WebViewSession.getCapabilities() for the running environment. Unsupported
creation requests print a diagnostic and return null.