Langsung ke konten

@capgo/capacitor-webview-crash

Restart WebView yang crash secara native dan recycle WebView yang berjalan lama pada interval tetap

Restart WebView yang crash secara native dan recycle WebView yang berjalan lama pada interval tetap

Mulai dengan getPendingCrashInfo() dan metode inti lainnya yang tercantum di bawah ini.

PlatformDukunganCatatan
iOSYaNative
AndroidYaNative
WebParsialLihat panduan memulai
  • Restart crash native - Restart WebView dari iOS atau Android saat proses renderer mati.
  • Restart terjadwal - Recycle WebView yang berjalan lama dengan timer native menggunakan restartIntervalMs atau waktu aktual restartCron.
  • Restart native manual - Memungkinkan JavaScript meminta WebView native baru dengan restartWebView() tanpa melakukan reload halaman.
  • Konfigurasi Capacitor bertipe - Mengekspos WebViewCrashPluginConfig untuk plugins.WebViewCrash di capacitor.config.ts.
  • getPendingCrashInfo - Mengembalikan marker native crash atau restart yang tersimpan, atau null saat tidak ada yang tertunda.
  • clearPendingCrashInfo - Menghapus marker yang tersimpan setelah app memulihkan state-nya.
  • simulateCrashRecovery - Membuat marker crash palsu agar alur recovery bisa diuji secara lokal.
  • addListener - Memicu webViewRestoredAfterCrash untuk marker crash dan webViewRestoredAfterRestart untuk setiap native restart marker.
MetodeDeskripsi
getPendingCrashInfoMengembalikan marker crash native atau restart yang tersimpan, atau null saat tidak ada yang tertunda.
clearPendingCrashInfoMenghapus marker tersimpan setelah aplikasi Anda memulihkan state-nya.
simulateCrashRecoveryMembuat marker crash palsu agar alur recovery bisa diuji secara lokal.
restartWebViewMenulis reason: 'manualRestart' dan meminta native code untuk membuat WebView baru.
addListenerTerpicu webViewRestoredAfterCrash atau webViewRestoredAfterRestart saat listener terpasang dan marker yang cocok masih tertunda.
removeAllListenersMenghapus semua listener plugin.

Plugin ini memperluas Capacitor PluginsConfig dengan tipe WebViewCrash entri config bertipe:

export interface WebViewCrashPluginConfig {
restartOnCrash?: boolean;
restartIntervalMs?: number;
restartCron?: string;
restartAfterCrashDelayMs?: number;
}
  • Plugin ini mendeteksi pemulihan setelah crash WebView. Plugin ini tidak mencegah crash yang mendasarinya.
  • Runtime JavaScript yang dipulihkan adalah runtime baru, sehingga state in-memory apa pun dari WebView sebelumnya sudah hilang saat API ini dipicu.
  • Restart terjadwal ditetapkan reason: 'periodicRestart'; restart manual menulis reason: 'manualRestart'. Simpan state yang belum disimpan sebelum mengaktifkan interval restart pendek, jadwal cron, atau memanggil restartWebView().
  • restartCron menggunakan sintaks cron 5-field di zona waktu lokal perangkat, misalnya 0 3 * * * untuk restart harian pukul 03:00. Jangan konfigurasi kedua jadwal sekaligus: inisialisasi native akan memicu error konfigurasi fatal saat restartCron diatur dan restartIntervalMs lebih besar dari 0.
  • Di Android, field tambahan seperti didCrash dan rendererPriorityAtExit mungkin tersedia.
  • Di iOS, plugin mencatat appState ketika proses WebView yang diakhiri terdeteksi. Restart manual dan terjadwal membangun ulang bridge view Capacitor sehingga yang baru WKWebView dibuat.

Referensi ini disinkronkan dari src/definitions.ts di capacitor-webview-crash.

Jika Anda menggunakan @capgo/capacitor-webview-crash untuk merencanakan perilaku media dan antarmuka native, hubungkan dengan Menggunakan @capgo/capacitor-webview-crash untuk kapabilitas native di bagian Menggunakan @capgo/capacitor-webview-crash, Menggunakan @capgo/capacitor-live-activities untuk kemampuan native di Menggunakan @capgo/capacitor-live-activities, @capgo/capacitor-live-activities untuk detail implementasi di @capgo/capacitor-live-activities, Menggunakan @capgo/capacitor-video-player untuk kemampuan native di Menggunakan @capgo/capacitor-video-player, dan @capgo/capacitor-video-player untuk detail implementasi di @capgo/capacitor-video-player.