@capgo/capacitor-webview-crash

Resumen

This plugin stores a native marker when the previous Capacitor WebView process dies or is recycled, then exposes that marker to the next JavaScript runtime after the app recovers. It can also restart the WebView from native code after a crash, on a fixed interval, on a cron schedule, or when JavaScript explicitly requests restartWebView()lo que ayuda a las aplicaciones de kiosk, POS, panel de control, escáner y de señalización a evitar la acumulación de memoria durante sesiones largas.

Capacidades básicas

• Reinicio de crash nativo - Reinicia el WebView desde iOS o Android cuando el proceso de renderizado muere.
• Reinicio programado - Recicla WebViews de larga duración en un temporizador nativo utilizando restartIntervalMs o un reloj de pared restartCron.
• Reinicio manual nativo - Permite a JavaScript solicitar un WebView nativo fresco con restartWebView() sin realizar una recarga de página.
• Configuración Capacitor tipoada - Exposición WebViewCrashPluginConfig para plugins.WebViewCrash en capacitor.config.ts.
• getPendingCrashInfo - Devuelve el marcador de crash o reinicio nativo almacenado, o null cuando no hay nada pendiente.
• clearPendingCrashInfo - Borra el marcador almacenado después de que tu aplicación haya restaurado su estado.
• simulateCrashRecovery - Crea un marcador de crash falso para que los flujos de recuperación puedan ser probados localmente.
• addListener - Dispara webViewRestoredAfterCrash para marcadores de crash y webViewRestoredAfterRestart para cualquier marcador de reinicio nativo.

Pública API

Metodo	Descripcion
getPendingCrashInfo	Devuelve el marcador nativo de crash o reinicio almacenado, o null cuando no hay nada pendiente.
clearPendingCrashInfo	Limpia el marcador almacenado después de que tu aplicación haya restaurado su estado.
simulateCrashRecovery	Crear un marcador de crash falso para que los flujos de recuperación puedan ser probados localmente.
restartWebView	Escribe reason: 'manualRestart' y pregunta a code nativo para crear un WebView fresco.
addListener	Dispara webViewRestoredAfterCrash o webViewRestoredAfterRestart cuando un oyente se une y un marcador coincidente todavía está pendiente.
removeAllListeners	Elimina todos los oyentes de plugin.

Tipo de configuración

El complemento agrega un Capacitor tipo de configuración PluginsConfig con una configuración tipo WebViewCrash entrada:

export interface WebViewCrashPluginConfig {
  restartOnCrash?: boolean;
  restartIntervalMs?: number;
  restartCron?: string;
  restartAfterCrashDelayMs?: number;
}

Notas

• Este complemento detecta la recuperación después de un crash de WebView. No previene el crash subyacente.
• El tiempo de ejecución de JavaScript recuperado es nuevo, por lo que cualquier estado en memoria del WebView anterior ya se ha ido cuando este API dispara.
• Los reinicios programados escriben reason: 'periodicRestart'; los reinicios manuales escriben reason: 'manualRestart'. Persist el estado no guardado antes de habilitar intervalos de reinicio cortos, horarios de cron o llamadas restartWebView().
• restartCron usa la sintaxis de cron de 5 campos en el huso horario local del dispositivo, por ejemplo 0 3 * * * para un reinicio diario a las 03:00. No configure ambos horarios al mismo tiempo: la inicialización nativa lanza un error de configuración fatal cuando restartCron está configurado y restartIntervalMs es mayor que 0.
• En Android, campos adicionales como didCrash y rendererPriorityAtExit pueden estar disponibles.
• En iOS, el plugin registra appState cuando se observa el proceso de WebView terminado. Los reinicios manuales y programados reconstruyen la vista del puente Capacitor para crear un nuevo WKWebView Fuente de Verdad

Fuente de Verdad

Esta referencia está sincronizada desde src/definitions.ts en capacitor-webview-crash.

Sigue adelante desde @capgo/capacitor-webview-crash

Si estás utilizando @capgo/capacitor-webview-crash para planificar el comportamiento de medios y interfaz nativa, conecta con Usando @capgo/capacitor-webview-crash para la capacidad nativa en Usando @capgo/capacitor-webview-crash Usando @capgo/capacitor-live-activities para la capacidad nativa en Usando @capgo/capacitor-actividades-en-vivo, @capgo/capacitor-actividades-en-vivo para el detalle de implementación en @capgo/capacitor-actividades-en-vivo, Usando @capgo/capacitor-reproductor-de-videos para la capacidad nativa en Usando @capgo/capacitor-reproductor-de-videos, y @capgo/capacitor-reproductor-de-videos para el detalle de implementación en @capgo/capacitor-reproductor-de-videos.