@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 señalización a evitar la acumulación de memoria durante sesiones largas.

Capacidades principales

• Reiniciar de crash nativo - Reinicia la WebView desde iOS o Android cuando muere el proceso del renderizador.
• Reiniciar programado - Recicla las WebViews de larga duración en un temporizador nativo utilizando restartIntervalMs o un reloj de pared restartCron.
• Reiniciar nativo manual - Permite a JavaScript solicitar una WebView nativa fresca sin realizar una recarga de página. restartWebView() Configuración de tipo __CAPGO_KEEP_0__ - Exposición
• Typed Capacitor config - Exposes WebViewCrashPluginConfig en plugins.WebViewCrash - Devuelve el marcador de crash o reinicio nativo almacenado, o capacitor.config.ts.
• getPendingCrashInfo cuando no hay nada pendiente. null - Borra el marcador almacenado después de que su aplicación haya restaurado su estado.
• clearPendingCrashInfo Reiniciar programado - Recicla las WebViews de larga duración en un temporizador nativo utilizando __CAPGO_KEEP_0__ o un reloj de pared.
• simulateCrashRecovery - Crea un marcador de crash ficticio 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.

Sección pública API

Descripción	Devuelve el marcador de crash o reinicio nativo almacenado, o
getPendingCrashInfo	cuando no hay nada pendiente. null Elimina el marcador almacenado después de que tu aplicación haya restaurado su estado.
clearPendingCrashInfo	Crea un marcador de crash ficticio para que los flujos de recuperación puedan ser probados localmente.
simulateCrashRecovery	Public __CAPGO_KEEP_0__
restartWebView	Escribe reason: 'manualRestart' y le pide a code nativo que cree una WebView fresca.
addListener	Dispara webViewRestoredAfterCrash o webViewRestoredAfterRestart ¿O qué?
removeAllListeners	cuando un oyente se adjunta y un marcador coincidente sigue pendiente.

Elimina todos los oyentes de plugins.

The plugin augments Capacitor’s PluginsConfig La extensión agrega a __CAPGO_KEEP_0__’s WebViewCrash con una entrada de configuración tipada:

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

Notas

• Este plugin detecta la recuperación después de un crash de WebView. No previene el crash subyacente.
• El entorno de tiempo de ejecución de JavaScript recuperado es nuevo, por lo que cualquier estado en memoria desde el WebView anterior ya se ha ido cuando se dispara este API.
• Reinicios programados escriben reason: 'periodicRestart'; reinicios manuales escriben reason: 'manualRestart'. Guarda el estado no guardado antes de habilitar intervalos de reinicio cortos, horarios de cron, o llamar restartWebView().
• restartCron usa la sintaxis de 5 campos de cron en la zona horaria 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, los campos adicionales como didCrash y rendererPriorityAtExit puede estar disponible.
• En iOS, el complemento registra appState cuando se observa el proceso de WebView terminado. Los reinicios manuales y programados reconstruyen la Capacitor bridge de vista para crear un nuevo WKWebView Fuente de Verdad

Título de la sección “Fuente de Verdad”

en src/definitions.ts __CAPGO_KEEP_0__-webview-crash Sigue adelante desde @capacitor/__CAPGO_KEEP_1__-webview-crash.

Título de la sección “Sigue adelante desde @capgo/capacitor-webview-crash”

If 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-live-activities, @capgo/capacitor-live-activities para el detalle de implementación en @capgo/capacitor-live-activities, Usando @capgo/capacitor-video-player para la capacidad nativa en Usando @capgo/capacitor-video-player, y @capgo/capacitor-video-player {"targetLanguage":"Spanish","pagePath":"/es/docs/plugins/webview-crash/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"para el detalle de implementación en @capgo/capacitor-reproductor-de-videos."},{"text":"Editar página"}]}