Troubleshooting

Troubleshooting

The client cannot connect

Confirm Mimic prints its listening URL, keep the process alive, and use the same HTTP origin in connectOverCDP or browserURL. Avoid exposing the unauthenticated endpoint publicly.

The application loaded but is not ready

The browser load event can precede hydration. Wait for a selector, text, or application state that represents readiness instead of relying only on waitUntil: "load".

A command is unsupported

Query Mimic.getCompatibilityMatrix and reduce the workflow to the command and observable behavior it needs. A command accepted for client initialization may still have an explicit unsupported boundary.

Linux text geometry differs

Install Liberation, DejaVu, or Noto fonts. Exact Windows text metrics require matching legally available reference fonts.