Skip to content

device_reset_state

One-shot preflight: revoke/reset permissions, clear MMKV storage keys, force-stop the app, then relaunch + reconnect CDP. Composes device_permission + cdp_mmkv + simctl/adb terminate+launch in one atomic call. Best-effort with per-step status — never silently rolls back. Sequence: permission → storage → terminate → launch → reconnect → helpers (→ optional nav_ready). On iOS, permission state is not queryable post-revoke (simctl limitation) — ok: true only means the shell-out exited 0. Returns { summary: {ok, failed, skipped}, steps: […], reconnected, helpersInjected }.

NameTypeRequiredDefaultConstraintsDescription
appIdstringYesApp bundle ID, e.g. “com.example.app”.
platformunknownNoForce platform. Auto-detected from booted devices if omitted.
permissionsunknownNo
storageKeysunknownNo
mmkvInstanceIdunknownNoForwarded to cdp_mmkv. Defaults to mmkv.default.
relaunchbooleanNoLaunch the app after terminate. Default true.
waitForReadyunknownNo
waitForNavReadyunknownNo
device_reset_state(appId: <string>)