@capgo/capacitor-webview-crash 8.1.10 → 8.1.12

package/README.md

@@ -1,24 +1,48 @@
 # @capgo/capacitor-webview-crash
 
-<a href="https://capgo.app/">
+Keep your Capacitor app alive when the WebView crashes: detect recovered crashes, restart dead WebViews natively, and recycle long-running WebViews before they run out of memory.
+
+<a href="https://capgo.app/?ref=plugin_webview_crash">
   <img
-    src="https://raw.githubusercontent.com/Cap-go/capgo/main/assets/capgo_banner.png"
-    alt="Capgo - Instant updates for Capacitor"
+    src="https://capgo.app/readme-banner.svg?repo=Cap-go/capacitor-webview-crash"
+    alt="Capgo - Build Capacitor apps with AI, ship updates instantly"
   />
 </a>
 
 <div align="center">
+  <p>
+    <b>Capgo</b>: push fixes to your Capacitor users in minutes, build signed iOS and Android apps without a Mac, and
+    roll back in one click.
+  </p>
   <h2>
-    <a href="https://capgo.app/?ref=plugin_webview_crash"> ➡️ Get Instant updates for your App with Capgo</a>
+    <a href="https://capgo.app/register/?ref=plugin_webview_crash">➡️ Get started for free</a>
   </h2>
-  <h2>
+  <p>14-day unlimited free trial. No credit card required</p>
+  <p>
     <a href="https://capgo.app/consulting/?ref=plugin_webview_crash">
-      Missing a feature? We’ll build the plugin for you 💪
+      Missing a feature? We'll build the plugin for you 💪
     </a>
-  </h2>
+  </p>
 </div>
 
-Detect recovered Capacitor WebView crashes, restart dead WebViews natively, and optionally recycle long-running WebViews on a fixed interval before memory pressure turns into an OOM.
+> 🤖 **Building with an AI coding agent?** Install [Capgo skills](https://capgo.app/skills/?ref=plugin_webview_crash) so Claude Code, Codex, Cursor, Copilot, or Gemini CLI know how to install and use `@capgo/capacitor-webview-crash` in your Capacitor app: `npx skills add Cap-go/capgo-skills`. Then ask your agent: _"Add @capgo/capacitor-webview-crash to my Capacitor app and wire it up."_ [Agent setup guides](https://capgo.app/agents/?ref=plugin_webview_crash) · [Hosted MCP](https://capgo.app/docs/ai/mcp/?ref=plugin_webview_crash)
+
+<p align="center">
+  <img
+    src="https://raw.githubusercontent.com/Cap-go/capacitor-webview-crash/main/assets/github-social-preview.png"
+    alt="@capgo/capacitor-webview-crash for Capacitor apps"
+    width="300"
+  />
+</p>
+
+## Key features
+
+- **Crash recovery**: `restartOnCrash` restarts the WebView when its renderer process dies.
+- **Recovery info**: `getPendingCrashInfo()` and `clearPendingCrashInfo()`, plus the `webViewRestoredAfterCrash` event.
+- **Scheduled recycling**: `restartIntervalMs` or `restartCron` replaces long-running WebViews.
+- **Manual restart**: `restartWebView()` creates a fresh WebView.
+- **Testing**: `simulateCrashRecovery()` exercises your recovery flow.
+- **Platforms**: iOS and Android. Web only supports the testing helpers.
 
 ## What It Does
 

package/ios/Sources/WebViewCrashPlugin/WebViewCrash.swift

@@ -1,6 +1,5 @@
 import Capacitor
 import Foundation
-import ObjectiveC.runtime
 import UIKit
 import WebKit
 
@@ -292,31 +291,98 @@ enum WebViewCrashStore {
     }
 }
 
-enum WebViewCrashSwizzler {
-    private static var didInstall = false
-
-    static func installIfNeeded() {
-        guard !didInstall else {
+enum WebViewCrashNavigationDelegateInstaller {
+    /// Retains the proxy because `WKWebView.navigationDelegate` is weak.
+    private static var retainedProxy: WebViewCrashNavigationDelegateProxy?
+
+    /// Installs a typed `WKNavigationDelegate` proxy on the bridge web view.
+    ///
+    /// Ordering: call after Capacitor assigns `navigationDelegate` (plugin `load()` or after
+    /// `loadWebView()`). If another plugin replaces `navigationDelegate` later, crash handling
+    /// stops until this installer runs again. Manual or periodic restarts re-install via
+    /// `recreateBridgeWebView()`.
+    static func installIfNeeded(on webView: WKWebView?) {
+        guard let webView else {
             return
         }
 
-        let originalSelector = #selector(WebViewDelegationHandler.webViewWebContentProcessDidTerminate(_:))
-        let swizzledSelector = #selector(WebViewDelegationHandler.capgo_webViewCrash_webViewWebContentProcessDidTerminate(_:))
+        if webView.navigationDelegate is WebViewCrashNavigationDelegateProxy {
+            return
+        }
 
-        guard
-            let originalMethod = class_getInstanceMethod(WebViewDelegationHandler.self, originalSelector),
-            let swizzledMethod = class_getInstanceMethod(WebViewDelegationHandler.self, swizzledSelector)
-        else {
+        guard let handler = webView.navigationDelegate as? WebViewDelegationHandler else {
             return
         }
 
-        method_exchangeImplementations(originalMethod, swizzledMethod)
-        didInstall = true
+        let proxy = WebViewCrashNavigationDelegateProxy(handler: handler)
+        retainedProxy = proxy
+        webView.navigationDelegate = proxy
     }
 }
 
-private extension WebViewDelegationHandler {
-    @objc func capgo_webViewCrash_webViewWebContentProcessDidTerminate(_ webView: WKWebView) {
+final class WebViewCrashNavigationDelegateProxy: NSObject, WKNavigationDelegate {
+    private weak var handler: WebViewDelegationHandler?
+
+    init(handler: WebViewDelegationHandler) {
+        self.handler = handler
+        super.init()
+    }
+
+    func webView(_ webView: WKWebView, didStartProvisionalNavigation navigation: WKNavigation!) {
+        handler?.webView(webView, didStartProvisionalNavigation: navigation)
+    }
+
+    func webView(
+        _ webView: WKWebView,
+        requestMediaCapturePermissionFor origin: WKSecurityOrigin,
+        initiatedByFrame frame: WKFrameInfo,
+        type: WKMediaCaptureType,
+        decisionHandler: @escaping (WKPermissionDecision) -> Void
+    ) {
+        handler?.webView(
+            webView,
+            requestMediaCapturePermissionFor: origin,
+            initiatedByFrame: frame,
+            type: type,
+            decisionHandler: decisionHandler
+        )
+    }
+
+    func webView(
+        _ webView: WKWebView,
+        requestDeviceOrientationAndMotionPermissionFor origin: WKSecurityOrigin,
+        initiatedByFrame frame: WKFrameInfo,
+        decisionHandler: @escaping (WKPermissionDecision) -> Void
+    ) {
+        handler?.webView(
+            webView,
+            requestDeviceOrientationAndMotionPermissionFor: origin,
+            initiatedByFrame: frame,
+            decisionHandler: decisionHandler
+        )
+    }
+
+    func webView(
+        _ webView: WKWebView,
+        decidePolicyFor navigationAction: WKNavigationAction,
+        decisionHandler: @escaping (WKNavigationActionPolicy) -> Void
+    ) {
+        handler?.webView(webView, decidePolicyFor: navigationAction, decisionHandler: decisionHandler)
+    }
+
+    func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {
+        handler?.webView(webView, didFinish: navigation)
+    }
+
+    func webView(_ webView: WKWebView, didFail navigation: WKNavigation!, withError error: Error) {
+        handler?.webView(webView, didFail: navigation, withError: error)
+    }
+
+    func webView(_ webView: WKWebView, didFailProvisionalNavigation navigation: WKNavigation!, withError error: Error) {
+        handler?.webView(webView, didFailProvisionalNavigation: navigation, withError: error)
+    }
+
+    func webViewWebContentProcessDidTerminate(_ webView: WKWebView) {
         let crashInfo = WebViewCrashStore.buildCrashInfo(
             platform: "ios",
             reason: "webContentProcessDidTerminate",
@@ -330,17 +396,28 @@ private extension WebViewDelegationHandler {
             return
         }
 
-        let restart = {
-            self.capgo_webViewCrash_webViewWebContentProcessDidTerminate(webView)
+        let forwardToCapacitor: () -> Void = { [weak self] in
+            guard let handler = self?.handler else {
+                return
+            }
+            handler.webViewWebContentProcessDidTerminate(webView)
         }
 
         let delay = WebViewCrashRuntime.restartAfterCrashDelaySeconds
         if delay > 0 {
-            DispatchQueue.main.asyncAfter(deadline: .now() + delay, execute: restart)
+            DispatchQueue.main.asyncAfter(deadline: .now() + delay, execute: forwardToCapacitor)
         } else {
-            restart()
+            forwardToCapacitor()
         }
     }
+
+    func webView(
+        _ webView: WKWebView,
+        didReceive challenge: URLAuthenticationChallenge,
+        completionHandler: @escaping @MainActor (URLSession.AuthChallengeDisposition, URLCredential?) -> Void
+    ) {
+        handler?.webView(webView, didReceive: challenge, completionHandler: completionHandler)
+    }
 }
 
 extension UIApplication.State {

package/ios/Sources/WebViewCrashPlugin/WebViewCrashPlugin.swift

@@ -20,7 +20,7 @@ public class WebViewCrashPlugin: CAPPlugin, CAPBridgedPlugin {
     override public func load() {
         restartOptions = WebViewCrashRestartOptions(config: getConfig())
         WebViewCrashRuntime.update(options: restartOptions)
-        WebViewCrashSwizzler.installIfNeeded()
+        WebViewCrashNavigationDelegateInstaller.installIfNeeded(on: bridge?.webView)
         schedulePeriodicRestart()
     }
 
@@ -147,6 +147,7 @@ public class WebViewCrashPlugin: CAPPlugin, CAPBridgedPlugin {
         viewController.webView?.uiDelegate = nil
         viewController.loadView()
         viewController.loadWebView()
+        WebViewCrashNavigationDelegateInstaller.installIfNeeded(on: viewController.webView)
         return true
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-webview-crash",
-  "version": "8.1.10",
+  "version": "8.1.12",
   "description": "Capacitor plugin for detecting WebView crash recovery and restarting long-running WebViews natively.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",