@capgo/capacitor-webview-crash 8.0.2 → 8.1.0

package/android/src/main/java/app/capgo/webviewcrash/WebViewCrashPlugin.java

@@ -1,5 +1,7 @@
 package app.capgo.webviewcrash;
 
+import android.os.Handler;
+import android.os.Looper;
 import android.webkit.RenderProcessGoneDetail;
 import android.webkit.WebView;
 import androidx.appcompat.app.AppCompatActivity;
@@ -9,12 +11,26 @@ import com.getcapacitor.PluginCall;
 import com.getcapacitor.PluginMethod;
 import com.getcapacitor.WebViewListener;
 import com.getcapacitor.annotation.CapacitorPlugin;
+import java.util.HashSet;
+import java.util.Set;
 
 @CapacitorPlugin(name = "WebViewCrash")
 public class WebViewCrashPlugin extends Plugin {
 
     private final WebViewCrash implementation = new WebViewCrash();
-    private boolean didDispatchPendingEvent = false;
+    private final Set<String> dispatchedPendingEvents = new HashSet<>();
+    private WebViewCrash.RestartOptions restartOptions = new WebViewCrash.RestartOptions(true, 0, null, 0);
+    private Handler mainHandler;
+
+    private final Runnable periodicRestartRunnable = () -> {
+        WebView webView = bridge != null ? bridge.getWebView() : null;
+        String url = webView != null ? webView.getUrl() : null;
+        JSObject restartInfo = implementation.buildCrashInfo(WebViewCrash.PERIODIC_RESTART_REASON, url, null, null);
+
+        implementation.writePendingCrashInfo(getContext(), restartInfo);
+        dispatchedPendingEvents.clear();
+        restartWebView(0);
+    };
 
     private final WebViewListener webViewListener = new WebViewListener() {
         @Override
@@ -27,36 +43,37 @@ public class WebViewCrashPlugin extends Plugin {
             );
 
             implementation.writePendingCrashInfo(getContext(), crashInfo);
-            didDispatchPendingEvent = false;
+            dispatchedPendingEvents.clear();
 
-            AppCompatActivity currentActivity = getActivity();
-            if (currentActivity != null) {
-                currentActivity.runOnUiThread(() -> {
-                    bridge.reset();
-                    currentActivity.recreate();
-                });
+            if (!restartOptions.restartOnCrash) {
+                return false;
             }
 
+            restartWebView(restartOptions.restartAfterCrashDelayMs);
             return true;
         }
     };
 
     @Override
     public void load() {
+        restartOptions = implementation.readRestartOptions(getConfig());
         bridge.addWebViewListener(webViewListener);
+        schedulePeriodicRestart();
     }
 
     @Override
     protected void handleOnDestroy() {
         bridge.removeWebViewListener(webViewListener);
+        cancelPeriodicRestart();
     }
 
     @Override
     public void addListener(PluginCall call) {
         super.addListener(call);
 
-        if (WebViewCrash.EVENT_NAME.equals(call.getString("eventName"))) {
-            dispatchPendingCrashIfNeeded();
+        String eventName = call.getString("eventName");
+        if (WebViewCrash.CRASH_EVENT_NAME.equals(eventName) || WebViewCrash.RESTART_EVENT_NAME.equals(eventName)) {
+            dispatchPendingCrashIfNeeded(eventName);
         }
     }
 
@@ -70,7 +87,7 @@ public class WebViewCrashPlugin extends Plugin {
     @PluginMethod
     public void clearPendingCrashInfo(PluginCall call) {
         implementation.clearPendingCrashInfo(getContext());
-        didDispatchPendingEvent = false;
+        dispatchedPendingEvents.clear();
         call.resolve();
     }
 
@@ -80,25 +97,89 @@ public class WebViewCrashPlugin extends Plugin {
         JSObject crashInfo = implementation.buildCrashInfo("simulated", url, null, null);
 
         implementation.writePendingCrashInfo(getContext(), crashInfo);
-        didDispatchPendingEvent = false;
-        dispatchPendingCrashIfNeeded();
+        dispatchedPendingEvents.clear();
+        dispatchPendingCrashIfNeeded(WebViewCrash.CRASH_EVENT_NAME);
+        dispatchPendingCrashIfNeeded(WebViewCrash.RESTART_EVENT_NAME);
 
         JSObject result = new JSObject();
         result.put("value", crashInfo);
         call.resolve(result);
     }
 
-    private void dispatchPendingCrashIfNeeded() {
-        if (didDispatchPendingEvent) {
+    @PluginMethod
+    public void restartWebView(PluginCall call) {
+        WebView webView = bridge != null ? bridge.getWebView() : null;
+        String url = webView != null ? webView.getUrl() : null;
+        JSObject restartInfo = implementation.buildCrashInfo(WebViewCrash.MANUAL_RESTART_REASON, url, null, null);
+
+        implementation.writePendingCrashInfo(getContext(), restartInfo);
+        dispatchedPendingEvents.clear();
+
+        JSObject result = new JSObject();
+        result.put("value", restartInfo);
+        call.resolve(result);
+
+        restartWebView(0);
+    }
+
+    private void dispatchPendingCrashIfNeeded(String eventName) {
+        if (dispatchedPendingEvents.contains(eventName)) {
             return;
         }
 
         JSObject crashInfo = implementation.readPendingCrashInfo(getContext());
-        if (crashInfo == null) {
+        if (crashInfo == null || !implementation.shouldDispatchEvent(eventName, crashInfo)) {
+            return;
+        }
+
+        dispatchedPendingEvents.add(eventName);
+        notifyListeners(eventName, crashInfo);
+    }
+
+    private void schedulePeriodicRestart() {
+        cancelPeriodicRestart();
+        Long delayMs = restartOptions.nextRestartDelayMs();
+        if (delayMs == null || delayMs <= 0) {
             return;
         }
 
-        didDispatchPendingEvent = true;
-        notifyListeners(WebViewCrash.EVENT_NAME, crashInfo);
+        getMainHandler().postDelayed(periodicRestartRunnable, delayMs);
+    }
+
+    private void cancelPeriodicRestart() {
+        if (mainHandler != null) {
+            mainHandler.removeCallbacks(periodicRestartRunnable);
+        }
+    }
+
+    private void restartWebView(int delayMs) {
+        Runnable restart = () -> {
+            AppCompatActivity currentActivity = getActivity();
+            if (currentActivity == null) {
+                schedulePeriodicRestart();
+                return;
+            }
+
+            currentActivity.runOnUiThread(() -> {
+                if (bridge != null) {
+                    bridge.reset();
+                }
+                currentActivity.recreate();
+            });
+        };
+
+        if (delayMs > 0) {
+            getMainHandler().postDelayed(restart, delayMs);
+        } else {
+            getMainHandler().post(restart);
+        }
+    }
+
+    private Handler getMainHandler() {
+        if (mainHandler == null) {
+            mainHandler = new Handler(Looper.getMainLooper());
+        }
+
+        return mainHandler;
     }
 }

package/dist/docs.json

@@ -2,7 +2,7 @@
   "api": {
     "name": "WebViewCrashPlugin",
     "slug": "webviewcrashplugin",
-    "docs": "Capacitor API for recovered WebView crash detection.",
+    "docs": "Capacitor API for recovered WebView crash and restart detection.",
     "tags": [],
     "methods": [
       {
@@ -11,7 +11,7 @@
         "parameters": [],
         "returns": "Promise<PendingCrashInfoResult>",
         "tags": [],
-        "docs": "Returns the pending native crash marker, if one exists.",
+        "docs": "Returns the pending native crash or restart marker, if one exists.",
         "complexTypes": [
           "PendingCrashInfoResult"
         ],
@@ -23,7 +23,7 @@
         "parameters": [],
         "returns": "Promise<void>",
         "tags": [],
-        "docs": "Clears the stored crash marker after the app has handled recovery.",
+        "docs": "Clears the stored marker after the app has handled recovery.",
         "complexTypes": [],
         "slug": "clearpendingcrashinfo"
       },
@@ -39,14 +39,26 @@
         ],
         "slug": "simulatecrashrecovery"
       },
+      {
+        "name": "restartWebView",
+        "signature": "() => Promise<PendingCrashInfoResult>",
+        "parameters": [],
+        "returns": "Promise<PendingCrashInfoResult>",
+        "tags": [],
+        "docs": "Stores a manual restart marker and asks native code to create a fresh WebView.\n\nOn Android this recreates the host Activity. On iOS this rebuilds the Capacitor bridge view so a new `WKWebView`\ninstance is created instead of reloading the current page.",
+        "complexTypes": [
+          "PendingCrashInfoResult"
+        ],
+        "slug": "restartwebview"
+      },
       {
         "name": "addListener",
-        "signature": "(eventName: 'webViewRestoredAfterCrash', listenerFunc: (info: WebViewCrashInfo) => void) => Promise<PluginListenerHandle>",
+        "signature": "(eventName: 'webViewRestoredAfterCrash' | 'webViewRestoredAfterRestart', listenerFunc: (info: WebViewCrashInfo) => void) => Promise<PluginListenerHandle>",
         "parameters": [
           {
             "name": "eventName",
             "docs": "",
-            "type": "'webViewRestoredAfterCrash'"
+            "type": "'webViewRestoredAfterCrash' | 'webViewRestoredAfterRestart'"
           },
           {
             "name": "listenerFunc",
@@ -56,12 +68,12 @@
         ],
         "returns": "Promise<PluginListenerHandle>",
         "tags": [],
-        "docs": "Fires after a new JavaScript runtime attaches a listener and a crash marker is still pending.",
+        "docs": "Fires after a new JavaScript runtime attaches a listener and a matching marker is still pending.",
         "complexTypes": [
           "PluginListenerHandle",
           "WebViewCrashInfo"
         ],
-        "slug": "addlistenerwebviewrestoredaftercrash-"
+        "slug": "addlistenerwebviewrestoredaftercrash--webviewrestoredafterrestart-"
       },
       {
         "name": "removeAllListeners",
@@ -80,14 +92,14 @@
     {
       "name": "PendingCrashInfoResult",
       "slug": "pendingcrashinforesult",
-      "docs": "Pending crash marker returned to JavaScript.",
+      "docs": "Pending crash or restart marker returned to JavaScript.",
       "tags": [],
       "methods": [],
       "properties": [
         {
           "name": "value",
           "tags": [],
-          "docs": "Stored crash metadata, or `null` when no marker is pending.",
+          "docs": "Stored crash or restart metadata, or `null` when no marker is pending.",
           "complexTypes": [
             "WebViewCrashInfo"
           ],
@@ -98,14 +110,14 @@
     {
       "name": "WebViewCrashInfo",
       "slug": "webviewcrashinfo",
-      "docs": "Metadata captured natively after the previous WebView process died.",
+      "docs": "Metadata captured natively after the previous WebView process died or was restarted.",
       "tags": [],
       "methods": [],
       "properties": [
         {
           "name": "platform",
           "tags": [],
-          "docs": "Platform that detected and stored the crash marker.",
+          "docs": "Platform that detected and stored the marker.",
           "complexTypes": [
             "WebViewCrashPlatform"
           ],
@@ -114,7 +126,7 @@
         {
           "name": "timestamp",
           "tags": [],
-          "docs": "Unix timestamp in milliseconds for when the crash marker was written.",
+          "docs": "Unix timestamp in milliseconds for when the marker was written.",
           "complexTypes": [],
           "type": "number"
         },
@@ -128,7 +140,7 @@
         {
           "name": "reason",
           "tags": [],
-          "docs": "Platform-specific reason for the crash marker.",
+          "docs": "Platform-specific reason for the crash or restart marker.",
           "complexTypes": [
             "WebViewCrashReason"
           ],
@@ -137,7 +149,7 @@
         {
           "name": "url",
           "tags": [],
-          "docs": "Last known WebView URL when the crash marker was written.",
+          "docs": "Last known WebView URL when the marker was written.",
           "complexTypes": [],
           "type": "string | undefined"
         },
@@ -158,7 +170,7 @@
         {
           "name": "appState",
           "tags": [],
-          "docs": "iOS-only application state captured when the crash marker was written.",
+          "docs": "iOS-only application state captured when the marker was written.",
           "complexTypes": [
             "WebViewCrashAppState"
           ],
@@ -188,7 +200,7 @@
     {
       "name": "WebViewCrashPlatform",
       "slug": "webviewcrashplatform",
-      "docs": "Platform that produced the stored crash marker.",
+      "docs": "Platform that produced the stored marker.",
       "types": [
         {
           "text": "'android'",
@@ -207,7 +219,7 @@
     {
       "name": "WebViewCrashReason",
       "slug": "webviewcrashreason",
-      "docs": "Native reason reported for the previous WebView failure.",
+      "docs": "Native reason reported for the previous WebView failure or restart.",
       "types": [
         {
           "text": "'renderProcessGone'",
@@ -217,6 +229,14 @@
           "text": "'webContentProcessDidTerminate'",
           "complexTypes": []
         },
+        {
+          "text": "'periodicRestart'",
+          "complexTypes": []
+        },
+        {
+          "text": "'manualRestart'",
+          "complexTypes": []
+        },
         {
           "text": "'simulated'",
           "complexTypes": []

package/dist/esm/definitions.d.ts

@@ -1,10 +1,58 @@
 import type { PluginListenerHandle } from '@capacitor/core';
+declare module '@capacitor/cli' {
+    interface PluginsConfig {
+        /**
+         * Configure native WebView restart behavior for `@capgo/capacitor-webview-crash`.
+         */
+        WebViewCrash?: WebViewCrashPluginConfig;
+    }
+}
+/**
+ * Native WebView restart behavior configured in `capacitor.config.ts`.
+ */
+export interface WebViewCrashPluginConfig {
+    /**
+     * Restart the WebView from native code when the renderer process dies.
+     *
+     * @default true
+     */
+    restartOnCrash?: boolean;
+    /**
+     * Fixed native interval, in milliseconds, for proactively replacing long-running WebViews.
+     *
+     * Set to `0` to disable interval restarts. Do not combine an active interval
+     * with `restartCron`; native initialization fails fast when both schedules are configured.
+     *
+     * @default 0
+     */
+    restartIntervalMs?: number;
+    /**
+     * Cron schedule for proactively replacing long-running WebViews.
+     *
+     * Uses standard 5-field cron syntax in the device local timezone:
+     * `minute hour day-of-month month day-of-week`.
+     *
+     * Examples:
+     * - `0 3 * * *` restarts every day at 03:00.
+     * - `0,30 * * * *` restarts every 30 minutes.
+     *
+     * Do not combine this with an active `restartIntervalMs`; native initialization
+     * fails fast when both schedules are configured.
+     */
+    restartCron?: string;
+    /**
+     * Delay, in milliseconds, before restarting after a crash.
+     *
+     * @default 0
+     */
+    restartAfterCrashDelayMs?: number;
+}
 /**
- * Native reason reported for the previous WebView failure.
+ * Native reason reported for the previous WebView failure or restart.
  */
-export type WebViewCrashReason = 'renderProcessGone' | 'webContentProcessDidTerminate' | 'simulated';
+export type WebViewCrashReason = 'renderProcessGone' | 'webContentProcessDidTerminate' | 'periodicRestart' | 'manualRestart' | 'simulated';
 /**
- * Platform that produced the stored crash marker.
+ * Platform that produced the stored marker.
  */
 export type WebViewCrashPlatform = 'android' | 'ios' | 'web';
 /**
@@ -12,15 +60,15 @@ export type WebViewCrashPlatform = 'android' | 'ios' | 'web';
  */
 export type WebViewCrashAppState = 'active' | 'inactive' | 'background' | 'unknown';
 /**
- * Metadata captured natively after the previous WebView process died.
+ * Metadata captured natively after the previous WebView process died or was restarted.
  */
 export interface WebViewCrashInfo {
     /**
-     * Platform that detected and stored the crash marker.
+     * Platform that detected and stored the marker.
      */
     platform: WebViewCrashPlatform;
     /**
-     * Unix timestamp in milliseconds for when the crash marker was written.
+     * Unix timestamp in milliseconds for when the marker was written.
      */
     timestamp: number;
     /**
@@ -28,11 +76,11 @@ export interface WebViewCrashInfo {
      */
     timestampISO: string;
     /**
-     * Platform-specific reason for the crash marker.
+     * Platform-specific reason for the crash or restart marker.
      */
     reason: WebViewCrashReason;
     /**
-     * Last known WebView URL when the crash marker was written.
+     * Last known WebView URL when the marker was written.
      */
     url?: string;
     /**
@@ -44,29 +92,29 @@ export interface WebViewCrashInfo {
      */
     rendererPriorityAtExit?: number;
     /**
-     * iOS-only application state captured when the crash marker was written.
+     * iOS-only application state captured when the marker was written.
      */
     appState?: WebViewCrashAppState;
 }
 /**
- * Pending crash marker returned to JavaScript.
+ * Pending crash or restart marker returned to JavaScript.
  */
 export interface PendingCrashInfoResult {
     /**
-     * Stored crash metadata, or `null` when no marker is pending.
+     * Stored crash or restart metadata, or `null` when no marker is pending.
      */
     value: WebViewCrashInfo | null;
 }
 /**
- * Capacitor API for recovered WebView crash detection.
+ * Capacitor API for recovered WebView crash and restart detection.
  */
 export interface WebViewCrashPlugin {
     /**
-     * Returns the pending native crash marker, if one exists.
+     * Returns the pending native crash or restart marker, if one exists.
      */
     getPendingCrashInfo(): Promise<PendingCrashInfoResult>;
     /**
-     * Clears the stored crash marker after the app has handled recovery.
+     * Clears the stored marker after the app has handled recovery.
      */
     clearPendingCrashInfo(): Promise<void>;
     /**
@@ -74,9 +122,16 @@ export interface WebViewCrashPlugin {
      */
     simulateCrashRecovery(): Promise<PendingCrashInfoResult>;
     /**
-     * Fires after a new JavaScript runtime attaches a listener and a crash marker is still pending.
+     * Stores a manual restart marker and asks native code to create a fresh WebView.
+     *
+     * On Android this recreates the host Activity. On iOS this rebuilds the Capacitor bridge view so a new `WKWebView`
+     * instance is created instead of reloading the current page.
+     */
+    restartWebView(): Promise<PendingCrashInfoResult>;
+    /**
+     * Fires after a new JavaScript runtime attaches a listener and a matching marker is still pending.
      */
-    addListener(eventName: 'webViewRestoredAfterCrash', listenerFunc: (info: WebViewCrashInfo) => void): Promise<PluginListenerHandle>;
+    addListener(eventName: 'webViewRestoredAfterCrash' | 'webViewRestoredAfterRestart', listenerFunc: (info: WebViewCrashInfo) => void): Promise<PluginListenerHandle>;
     /**
      * Removes all plugin listeners.
      */

package/dist/esm/definitions.js

@@ -1,2 +1,3 @@
+/// <reference types="@capacitor/cli" />
 export {};
 //# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\n/**\n * Native reason reported for the previous WebView failure.\n */\nexport type WebViewCrashReason = 'renderProcessGone' | 'webContentProcessDidTerminate' | 'simulated';\n\n/**\n * Platform that produced the stored crash marker.\n */\nexport type WebViewCrashPlatform = 'android' | 'ios' | 'web';\n\n/**\n * Best-effort application state captured on iOS when the WebView process died.\n */\nexport type WebViewCrashAppState = 'active' | 'inactive' | 'background' | 'unknown';\n\n/**\n * Metadata captured natively after the previous WebView process died.\n */\nexport interface WebViewCrashInfo {\n  /**\n   * Platform that detected and stored the crash marker.\n   */\n  platform: WebViewCrashPlatform;\n  /**\n   * Unix timestamp in milliseconds for when the crash marker was written.\n   */\n  timestamp: number;\n  /**\n   * ISO-8601 version of `timestamp`.\n   */\n  timestampISO: string;\n  /**\n   * Platform-specific reason for the crash marker.\n   */\n  reason: WebViewCrashReason;\n  /**\n   * Last known WebView URL when the crash marker was written.\n   */\n  url?: string;\n  /**\n   * Android-only hint from `RenderProcessGoneDetail.didCrash()`.\n   */\n  didCrash?: boolean;\n  /**\n   * Android-only renderer priority reported at exit.\n   */\n  rendererPriorityAtExit?: number;\n  /**\n   * iOS-only application state captured when the crash marker was written.\n   */\n  appState?: WebViewCrashAppState;\n}\n\n/**\n * Pending crash marker returned to JavaScript.\n */\nexport interface PendingCrashInfoResult {\n  /**\n   * Stored crash metadata, or `null` when no marker is pending.\n   */\n  value: WebViewCrashInfo | null;\n}\n\n/**\n * Capacitor API for recovered WebView crash detection.\n */\nexport interface WebViewCrashPlugin {\n  /**\n   * Returns the pending native crash marker, if one exists.\n   */\n  getPendingCrashInfo(): Promise<PendingCrashInfoResult>;\n\n  /**\n   * Clears the stored crash marker after the app has handled recovery.\n   */\n  clearPendingCrashInfo(): Promise<void>;\n\n  /**\n   * Creates a fake crash marker so recovery flows can be tested locally.\n   */\n  simulateCrashRecovery(): Promise<PendingCrashInfoResult>;\n\n  /**\n   * Fires after a new JavaScript runtime attaches a listener and a crash marker is still pending.\n   */\n  addListener(\n    eventName: 'webViewRestoredAfterCrash',\n    listenerFunc: (info: WebViewCrashInfo) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Removes all plugin listeners.\n   */\n  removeAllListeners(): Promise<void>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,wCAAwC","sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n\nimport type { PluginListenerHandle } from '@capacitor/core';\n\ndeclare module '@capacitor/cli' {\n  export interface PluginsConfig {\n    /**\n     * Configure native WebView restart behavior for `@capgo/capacitor-webview-crash`.\n     */\n    WebViewCrash?: WebViewCrashPluginConfig;\n  }\n}\n\n/**\n * Native WebView restart behavior configured in `capacitor.config.ts`.\n */\nexport interface WebViewCrashPluginConfig {\n  /**\n   * Restart the WebView from native code when the renderer process dies.\n   *\n   * @default true\n   */\n  restartOnCrash?: boolean;\n\n  /**\n   * Fixed native interval, in milliseconds, for proactively replacing long-running WebViews.\n   *\n   * Set to `0` to disable interval restarts. Do not combine an active interval\n   * with `restartCron`; native initialization fails fast when both schedules are configured.\n   *\n   * @default 0\n   */\n  restartIntervalMs?: number;\n\n  /**\n   * Cron schedule for proactively replacing long-running WebViews.\n   *\n   * Uses standard 5-field cron syntax in the device local timezone:\n   * `minute hour day-of-month month day-of-week`.\n   *\n   * Examples:\n   * - `0 3 * * *` restarts every day at 03:00.\n   * - `0,30 * * * *` restarts every 30 minutes.\n   *\n   * Do not combine this with an active `restartIntervalMs`; native initialization\n   * fails fast when both schedules are configured.\n   */\n  restartCron?: string;\n\n  /**\n   * Delay, in milliseconds, before restarting after a crash.\n   *\n   * @default 0\n   */\n  restartAfterCrashDelayMs?: number;\n}\n\n/**\n * Native reason reported for the previous WebView failure or restart.\n */\nexport type WebViewCrashReason =\n  | 'renderProcessGone'\n  | 'webContentProcessDidTerminate'\n  | 'periodicRestart'\n  | 'manualRestart'\n  | 'simulated';\n\n/**\n * Platform that produced the stored marker.\n */\nexport type WebViewCrashPlatform = 'android' | 'ios' | 'web';\n\n/**\n * Best-effort application state captured on iOS when the WebView process died.\n */\nexport type WebViewCrashAppState = 'active' | 'inactive' | 'background' | 'unknown';\n\n/**\n * Metadata captured natively after the previous WebView process died or was restarted.\n */\nexport interface WebViewCrashInfo {\n  /**\n   * Platform that detected and stored the marker.\n   */\n  platform: WebViewCrashPlatform;\n  /**\n   * Unix timestamp in milliseconds for when the marker was written.\n   */\n  timestamp: number;\n  /**\n   * ISO-8601 version of `timestamp`.\n   */\n  timestampISO: string;\n  /**\n   * Platform-specific reason for the crash or restart marker.\n   */\n  reason: WebViewCrashReason;\n  /**\n   * Last known WebView URL when the marker was written.\n   */\n  url?: string;\n  /**\n   * Android-only hint from `RenderProcessGoneDetail.didCrash()`.\n   */\n  didCrash?: boolean;\n  /**\n   * Android-only renderer priority reported at exit.\n   */\n  rendererPriorityAtExit?: number;\n  /**\n   * iOS-only application state captured when the marker was written.\n   */\n  appState?: WebViewCrashAppState;\n}\n\n/**\n * Pending crash or restart marker returned to JavaScript.\n */\nexport interface PendingCrashInfoResult {\n  /**\n   * Stored crash or restart metadata, or `null` when no marker is pending.\n   */\n  value: WebViewCrashInfo | null;\n}\n\n/**\n * Capacitor API for recovered WebView crash and restart detection.\n */\nexport interface WebViewCrashPlugin {\n  /**\n   * Returns the pending native crash or restart marker, if one exists.\n   */\n  getPendingCrashInfo(): Promise<PendingCrashInfoResult>;\n\n  /**\n   * Clears the stored marker after the app has handled recovery.\n   */\n  clearPendingCrashInfo(): Promise<void>;\n\n  /**\n   * Creates a fake crash marker so recovery flows can be tested locally.\n   */\n  simulateCrashRecovery(): Promise<PendingCrashInfoResult>;\n\n  /**\n   * Stores a manual restart marker and asks native code to create a fresh WebView.\n   *\n   * On Android this recreates the host Activity. On iOS this rebuilds the Capacitor bridge view so a new `WKWebView`\n   * instance is created instead of reloading the current page.\n   */\n  restartWebView(): Promise<PendingCrashInfoResult>;\n\n  /**\n   * Fires after a new JavaScript runtime attaches a listener and a matching marker is still pending.\n   */\n  addListener(\n    eventName: 'webViewRestoredAfterCrash' | 'webViewRestoredAfterRestart',\n    listenerFunc: (info: WebViewCrashInfo) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Removes all plugin listeners.\n   */\n  removeAllListeners(): Promise<void>;\n}\n"]}

package/dist/esm/web.d.ts

@@ -2,16 +2,19 @@ import type { PluginListenerHandle } from '@capacitor/core';
 import { WebPlugin } from '@capacitor/core';
 import type { PendingCrashInfoResult, WebViewCrashPlugin } from './definitions';
 export declare class WebViewCrashWeb extends WebPlugin implements WebViewCrashPlugin {
-    private didDispatchPendingEvent;
+    private dispatchedPendingEvents;
     getPendingCrashInfo(): Promise<PendingCrashInfoResult>;
     clearPendingCrashInfo(): Promise<void>;
     simulateCrashRecovery(): Promise<PendingCrashInfoResult>;
+    restartWebView(): Promise<PendingCrashInfoResult>;
     addListener(eventName: string, listenerFunc: (...args: any[]) => any): Promise<PluginListenerHandle>;
     private flushPendingCrashEvent;
+    private shouldDispatchEvent;
     private buildCrashInfo;
     private readPendingCrashInfo;
     private writePendingCrashInfo;
     private removePendingCrashInfo;
-    private static readonly eventName;
+    private static readonly crashEventName;
+    private static readonly restartEventName;
     private static readonly storageKey;
 }

package/dist/esm/web.js

@@ -2,48 +2,62 @@ import { WebPlugin } from '@capacitor/core';
 export class WebViewCrashWeb extends WebPlugin {
     constructor() {
         super(...arguments);
-        this.didDispatchPendingEvent = false;
+        this.dispatchedPendingEvents = new Set();
     }
     async getPendingCrashInfo() {
         return { value: this.readPendingCrashInfo() };
     }
     async clearPendingCrashInfo() {
         this.removePendingCrashInfo();
-        this.didDispatchPendingEvent = false;
+        this.dispatchedPendingEvents.clear();
     }
     async simulateCrashRecovery() {
         const value = this.buildCrashInfo();
         this.writePendingCrashInfo(value);
-        this.didDispatchPendingEvent = false;
+        this.dispatchedPendingEvents.clear();
         this.flushPendingCrashEvent();
+        this.flushPendingCrashEvent(WebViewCrashWeb.restartEventName);
+        return { value };
+    }
+    async restartWebView() {
+        const value = this.buildCrashInfo('manualRestart');
+        this.writePendingCrashInfo(value);
+        this.dispatchedPendingEvents.clear();
+        this.flushPendingCrashEvent(WebViewCrashWeb.restartEventName);
         return { value };
     }
     async addListener(eventName, listenerFunc) {
         const handle = await super.addListener(eventName, listenerFunc);
-        if (eventName === WebViewCrashWeb.eventName) {
-            this.flushPendingCrashEvent();
+        if (eventName === WebViewCrashWeb.crashEventName || eventName === WebViewCrashWeb.restartEventName) {
+            this.flushPendingCrashEvent(eventName);
         }
         return handle;
     }
-    flushPendingCrashEvent() {
-        if (this.didDispatchPendingEvent) {
+    flushPendingCrashEvent(eventName = WebViewCrashWeb.crashEventName) {
+        if (this.dispatchedPendingEvents.has(eventName)) {
             return;
         }
         const value = this.readPendingCrashInfo();
-        if (!value) {
+        if (!value || !this.shouldDispatchEvent(eventName, value)) {
             return;
         }
-        this.didDispatchPendingEvent = true;
-        this.notifyListeners(WebViewCrashWeb.eventName, value);
+        this.dispatchedPendingEvents.add(eventName);
+        this.notifyListeners(eventName, value);
+    }
+    shouldDispatchEvent(eventName, value) {
+        if (eventName === WebViewCrashWeb.crashEventName) {
+            return value.reason !== 'periodicRestart' && value.reason !== 'manualRestart';
+        }
+        return eventName === WebViewCrashWeb.restartEventName;
     }
-    buildCrashInfo() {
+    buildCrashInfo(reason = 'simulated') {
         var _a;
         const timestamp = Date.now();
         return {
             platform: 'web',
             timestamp,
             timestampISO: new Date(timestamp).toISOString(),
-            reason: 'simulated',
+            reason,
             url: (_a = globalThis.location) === null || _a === void 0 ? void 0 : _a.href,
             appState: 'active',
         };
@@ -70,6 +84,7 @@ export class WebViewCrashWeb extends WebPlugin {
         (_a = globalThis.localStorage) === null || _a === void 0 ? void 0 : _a.removeItem(WebViewCrashWeb.storageKey);
     }
 }
-WebViewCrashWeb.eventName = 'webViewRestoredAfterCrash';
+WebViewCrashWeb.crashEventName = 'webViewRestoredAfterCrash';
+WebViewCrashWeb.restartEventName = 'webViewRestoredAfterRestart';
 WebViewCrashWeb.storageKey = 'capgo.webview-crash.pending';
 //# sourceMappingURL=web.js.map