relaunchApp

suspend fun relaunchApp()

Force-terminates and relaunches the application process under test while maintaining the active test connection session.

Execution & Performance Notes

  • Desktop JVM: Destroys and re-launches the application window/process, introducing a 1 to 2-second boot latency.

  • Android & iOS: Force-terminates and restarts the native app process via driver hooks.

  • WasmJs: Performs a full browser tab reload.

Warning: Use relaunchApp() sparingly due to the 1-2s process boot latency on Desktop JVM. For fast test teardowns under 100ms across multiple tests, prefer using E2ETestLifecycle (beforeEach/afterEach) with in-app UI navigation resets.

Example Usage

relaunchApp()
assertVisible("splash_screen")

See also