Saltar al contenido

@capgo/capacitor-webview-crash

Reinicia WebViews caídos de forma nativa y recicla WebViews de larga duración a intervalos fijos

Reinicia WebViews caídos de forma nativa y recicla WebViews de larga duración a intervalos fijos

Comienza con getPendingCrashInfo() y los demás métodos principales detallados abajo.

PlataformaSoporteNotas
iOSSíNativo
AndroidSíNativo
WebParcialVer primeros pasos
  • Reinicio por crash nativo - Reinicia el WebView en iOS o Android cuando muere el proceso de renderizado.
  • Reinicio programado - Recicla WebViews de larga duración con un temporizador nativo usando restartIntervalMs o un reloj de tiempo real restartCron.
  • Reinicio nativo manual - Permite que JavaScript solicite un WebView nativo nuevo con restartWebView() sin recargar la página.
  • Configuración tipada de Capacitor - Expone 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 app haya restaurado su estado.
  • simulateCrashRecovery - Crea un marcador de crash falso para poder probar los flujos de recuperación localmente.
  • addListener - Dispara webViewRestoredAfterCrash para los marcadores de crash y webViewRestoredAfterRestart para cualquier marcador de reinicio nativo.
MétodoDescripción
getPendingCrashInfoDevuelve el marcador almacenado de crash nativo o reinicio, o null cuando no hay nada pendiente.
clearPendingCrashInfoBorra el marcador almacenado después de que tu app haya restaurado su estado.
simulateCrashRecoveryCrea un marcador de crash falso para probar los flujos de recuperación en local.
restartWebViewEscribe reason: 'manualRestart' y pide al code nativo que cree un WebView nuevo.
addListenerSe dispara webViewRestoredAfterCrash o webViewRestoredAfterRestart cuando se adjunta un listener y aún hay un marcador correspondiente pendiente.
removeAllListenersElimina todos los listeners del plugin.

El plugin amplía la configuración de Capacitor PluginsConfig con una entrada de configuración tipada WebViewCrash entrada de configuración:

export interface WebViewCrashPluginConfig {
restartOnCrash?: boolean;
restartIntervalMs?: number;
restartCron?: string;
restartAfterCrashDelayMs?: number;
}
  • Este plugin detecta la recuperación tras un crash de WebView. No previene el crash subyacente.
  • El runtime de JavaScript recuperado es nuevo, por lo que cualquier estado en memoria del WebView anterior ya ha desaparecido cuando se dispara este API.
  • Los reinicios programados funcionan reason: 'periodicRestart'; los reinicios manuales escriben reason: 'manualRestart'. Persista el estado no guardado antes de habilitar intervalos de reinicio cortos, programaciones cron o de llamar restartWebView().
  • restartCron usa la sintaxis cron de 5 campos en la zona horaria local del dispositivo, por ejemplo 0 3 * * * para un reinicio diario a las 03:00. No configures ambos horarios a la vez: 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 detecta el cierre del proceso WebView. Los reinicios manuales o programados reconstruyen la vista del bridge de Capacitor para que una nueva WKWebView se crea.

Esta referencia se sincroniza desde src/definitions.ts en capacitor-webview-crash.

Si estás usando @capgo/capacitor-webview-crash para planificar el comportamiento de los medios nativos y la interfaz, conéctalo con Usando @capgo/capacitor-webview-crash para la capacidad nativa en Usando @capgo/capacitor-webview-crash, Uso de @capgo/capacitor-live-activities para la capacidad nativa en Uso de @capgo/capacitor-live-activities, @capgo/capacitor-live-activities para los detalles de implementación en @capgo/capacitor-live-activities, Uso de @capgo/capacitor-video-player para la capacidad nativa en Uso de @capgo/capacitor-video-player, y @capgo/capacitor-video-player para el detalle de implementación en @capgo/capacitor-video-player.