vitexec

vitexec

References

• For mouse, keyboard, pointer lock, gamepad, or other input, read references/inputs.md.
• For CPU, network, performance timeline, or heap analysis, read references/performance.md.
• For WebXR, read references/webxr.md.

Workflow

1. Identify the page path if it is not

   /

   .
2. Write the smallest snippet that performs the user-like action or reads the browser-only state.
3. Run

   vitexec '<snippet>'

   , adding

   --path

   ,

   --gpu

   ,

   --screenshot

   ,

   --record

   ,

   --cpu-profile

   ,

   --network-trace

   ,

   --performance-trace

   ,

   --heap-snapshot

   ,

   --timeout

   , or

   --config

   only when needed.
4. Treat stdout as browser logs. It starts with

   logs:

   .

vitexec

vitexec

vitexec 'console.log("ready")'

vitexec --path /cart '
  import { useCartStore } from "/src/store/cart.ts";
  document.querySelector("[data-testid=add-to-cart]")?.click();
  await new Promise((resolve) => requestAnimationFrame(resolve));
  console.log("cart", JSON.stringify(useCartStore.getState()));
'

Guidance

• Prefer importing exported app state over scraping DOM when state is available.
• Use direct state reads for observation and assertions, not to bypass user interaction.
• Use live progress logs and focused assertions to early-exit on failures and see current progress.
• Keep logs concise; overly verbose logs become unreadable and unnecessarily fill the context.
• Prefer browser-root imports such as

  /src/store.ts

  , not local filesystem paths.
• Use

  --gpu

  for WebGL, canvas, Three.js, and WebXR behavior.
• If the local machine has no usable GPU, use

  --gpu --browser-ws-endpoint <ws-url>

  to connect to a remote Playwright server that was started with the right host-specific GPU settings.
• If repeated runs need the same endpoint or artifact settings, prefer

  VITEXEC_*

  environment variables over repeating long flags.
• Use screenshots or recordings only when visual evidence matters.
• Do not leave temporary code in the app when

  vitexec

  can inspect it from outside.