macOS

Backend

Package: NativeWebView.Platform.macOS
Platform enum: NativeWebViewPlatform.MacOS
Native engine: WKWebView

Current Repo Implementation Status

NativeWebView: implemented.
NativeWebDialog: implemented.
WebAuthenticationBroker: implemented through the macOS dialog runtime and a WKWebView auth window.
Check NativeWebViewPlatformImplementationStatusMatrix.Get(NativeWebViewPlatform.MacOS) when you need to distinguish implemented runtime paths from broader capability contracts.

Platform Engine Capability

Embedded view
GPU surface rendering
Offscreen rendering
Dialog
Authentication broker
Context menu and zoom
Printing and print UI
New window and resource request interception
Environment and controller options
Native handles
Cookie manager and command manager

Registration

factory.UseNativeWebViewMacOS();

Composition Notes

macOS supports composited hosting paths and passthrough decisions for scenarios such as hardware-accelerated video playback. Review Render Modes before forcing capture-based composition across all content types.

Proxy Notes

Per-instance proxy application is implemented for NativeWebView and NativeWebDialog on macOS 14+.
The current runtime path uses a dedicated persistent WKWebsiteDataStore identity derived from the instance configuration.
Explicit http, https, and socks5 proxy servers plus bypass domains are supported.
PAC (AutoConfigUrl) is not applied by the current macOS integration.

Authentication Notes

The current macOS WebAuthenticationBroker implementation uses a dedicated dialog-hosted WKWebView session and completes when navigation reaches the callback scheme/host/path.
UseHttpPost is not currently implemented on the macOS runtime path.