Extension 0.0.97

1. 10s timeout for CDP init commands — frozen or hibernated tabs (common in Ghost Browser and other Chromium forks) no longer block the entire Playwright connection setup. Init commands like Page.enable, Runtime.enable, and Network.enable time out individually after 10 seconds.
2. Multi-profile relay routing — extension connections are identified by per-profile install id, so two Chrome profiles signed into the same Google account no longer replace each other.
3. Better browser name detection — shows more specific browser names using full user-agent client hints.

playwriter@0.4.0

1. Cloud browser sessions via Browser Use — spin up stealth Chromium VMs in the cloud with playwriter session new --browser cloud. Supports residential proxies (--proxy us, --proxy de), custom proxies (--custom-proxy host:port), and configurable timeouts (--timeout 120). Idle sessions auto-disconnect after 10 minutes.

   New CLI commands:

   1234playwriter cloud login       # authenticate via device flow
   playwriter cloud status      # list active cloud VMs
   playwriter cloud subscribe   # open subscription page
   playwriter cloud live        # open live browser view

2. Headless browser mode — run without the extension or a visible browser:

   12playwriter browser install                    # download Chrome for Testing
   playwriter session new --browser headless      # launch headless Chrome

   Multiple sessions share the same Chrome process with isolated contexts.
3. API key authentication for cloud browsers — skip the interactive device flow in CI and headless environments:

   12export PLAYWRITER_API_KEY=pw_xxxxx
   playwriter session new --browser cloud

   Create and revoke keys at https://playwriter.dev/dashboard.
4. Fixed relay routing across Chrome profiles — two profiles signed into the same Google account no longer replace each other's relay connection.
5. Fixed cloud billing race conditions — concurrent cloud session requests now use durable per-org slot claims.
6. Fixed playwriter cloud login — uses Better Auth's current device authorization endpoints.

playwriter@0.3.1

1. Auto-page creation enabled by default — MCP and CLI sessions now automatically create a blank Playwriter-enabled tab when no targets are available, so agents can start working immediately without manual tab setup. Set PLAYWRITER_AUTO_ENABLE=false to disable.

playwriter@0.3.0

1. New sinceLastCall option for getLatestLogs() — inspect browser logs after every action without seeing duplicate messages:

   1playwriter -s 1 -e 'console.log(await getLatestLogs({ page, sinceLastCall: true }))'

   The first call returns all buffered console logs and page errors for the page. Later calls return only new entries since the previous sinceLastCall read. Logs also persist across navigations, so hydration errors, redirect failures, and startup exceptions are not lost when the page changes.
2. CDP logs now rotate automatically — ~/.playwriter/cdp.jsonl is capped at 10,000 entries by default to prevent unbounded disk growth. Set PLAYWRITER_CDP_LOG_MAX_ENTRIES to tune the cap. Rotation keeps the newest half of the log and writes through an atomic temp-file rename to avoid corrupting the JSONL file.
3. More reliable getLatestLogs({ page }) results — page runtime errors and console messages emitted by related frame targets now appear in the returned log stream. This makes React and hydration failures visible through pageerror entries instead of requiring manual console listeners.
4. CLI-created sessions auto-open pages more reliably — playwriter session new can auto-create an initial extension tab even when the shared relay was originally started by MCP. This avoids No Playwright pages are available after all enabled tabs have closed.
5. Remote status checks send bearer tokens — /extensions/status and /extension/status requests now include the configured auth token, so remote relays using --token no longer reject status checks with 403 responses.
6. Concurrent relay startup no longer crashes on port races — simultaneous CLI and MCP commands now deduplicate startup work and treat a competing process winning port 19988 as a clean handoff instead of surfacing EADDRINUSE.
7. Clearer multi-browser names in playwriter session new — browser lists now use full user-agent client hints when available, so Chromium-family browsers such as Chrome Canary can show a more specific name.
8. Skill docs prefer getLatestLogs() for page diagnostics — the generated Playwriter skill now tells agents to call getLatestLogs({ page }) instead of adding manual console listeners that miss errors emitted before listener setup.

Extension 0.0.94

1. Copy React Component Source Path right-click menu item. Right-click an element on a React page to copy the source file path (e.g. src/components/Button.tsx:42) to your clipboard. Uses bippy to walk the React fiber tree.
2. In-page floating toolbar with pin element mode. A compact dark pill toolbar injected into tabs with Playwriter attached. Pin elements to assign them to globalThis.playwriterPinnedElemN and copy the reference to clipboard. Shared pin counter between toolbar and context menu.
3. Pinned element clipboard copies a shell-ready command. Toolbar pins and context menu now copy playwriter -e 'inspectPinnedElement(...)' with React component inspection when supported. Bash-safe single-quote wrapping handles any page content.
4. Always-on ghost cursor injected into every attached tab via Page.addScriptToEvaluateOnNewDocument. Auto-hides after 5s of inactivity. Press feedback uses a dedicated 140ms ease-out, independent of move duration. Scale and transform-origin tuned per Emil Kowalski design principles.
5. Auto-relocate popup windows into tabs. OAuth popups and similar windows opened by connected tabs are moved into the source tab's window automatically, so agents no longer need cmd+click workarounds.
6. Cross-browser relay identity. Per-install installId persisted in chrome.storage.local prevents relay takeover when multiple Chromium-family browsers connect.
7. Fix debugger crash on pages with chrome-extension:// iframes (LastPass, SurfingKeys, password managers). Restricted iframes are removed before attach, and restricted child targets are filtered from CDP events.
8. Fix Target.detachFromTarget routing on root CDP session. Commands without a top-level sessionId now resolve via params.sessionId fallback instead of throwing.
9. Runtime-scoped root CDP tab session IDs prevent collisions across multiple Chrome profiles.
10. Skip welcome tab in packaged automation builds. The CLI-bundled extension no longer opens welcome.html on install.

playwriter@0.2.0

1. New -f/--file flag — execute JavaScript from a file instead of inline -e strings:

   1playwriter -s 1 -f script.js

   The file runs in the same sandbox as -e with all context variables (state, page, context, etc.) available. -e and -f are mutually exclusive.
2. React component inspection for pinned elements — call getReactComponentInfo({ locator }) to get the nearest React component name, parent hierarchy, sanitized props, and source file locations. Non-React elements return null.
3. Performance profiling guide — new performance-profiling.md resource covering TTFB, FCP, LCP, CLS measurement, heavy request detection, and interactivity blockers with concrete Playwriter + CDP snippets.
4. Shell tab completions — playwriter now supports shell completions via goke for tab completion on commands and flags.
5. Security: token required on all requests regardless of source — the previous loopback bypass on /cli/*, /recording/*, and /mcp-log let any request from 127.0.0.1 skip auth. Under tunnel setups (traforo/ngrok/cloudflared), every public request arrives from localhost, making the bypass equivalent to no auth. Fixed.
6. --token works on every remote subcommand — session new, session list, session delete, session reset, and browser list all forward Authorization: Bearer … to the relay. Previously only playwriter -e sent the token. Thanks @ivanleomk for the original fix.
7. POST /mcp-log is now token-protected — previously open to any reachable client.
8. Fixed Next.js webpack layer prefixes in React source paths — /(app-pages-browser)/, /(ssr)/, /(rsc)/ and other webpack layer prefixes are now stripped correctly.
9. Docs: absolute paths required for saved artifacts — page.screenshot({ path }), page.pdf({ path }), etc. must use absolute paths since Playwright resolves them outside the sandboxed fs.

playwriter@0.1.0

1. New in-page toolbar with pin mode (available when extension review completes) — every attached tab now gets a floating toolbar you can use to pin elements directly from the page. Pinning copies a natural-language prompt plus the exact playwriter -e '…' code needed to inspect that element later, so pasted prompts are immediately useful to an agent instead of just exposing a fragile DOM handle.
2. Always-on ghost cursor with better motion (available when extension review completes) — the cursor overlay now appears on every Playwriter-attached tab, survives hard navigations, uses smoother move/press animation timing, and fades away after 5 seconds of idle time so manual browsing stays uncluttered. The next Playwright-driven mouse action brings it back instantly.
3. Shared JavaScript dialogs no longer crash multi-client sessions — when multiple connectOverCDP() clients auto-close the same alert()/confirm()/prompt(), duplicate best-effort closes are now ignored instead of surfacing an unhandled rejection that kills the process.

playwriter@0.0.105

1. Popup windows auto-relocate to tabs — when a connected page opens a popup via window.open or target="_blank", the extension moves it into the source window as a regular tab and auto-attaches it. Agents no longer need the cmd+click workaround for OAuth flows.
2. New page warning replaces unreachable popup warning — the executor now emits [WARNING] New page opened from current page (index N, initial url: ...) pointing agents at the new tab. The old Popup window detected ... cannot be controlled by playwriter warning is gone.
3. Minimum extension version enforcement — if the installed extension is older than 0.0.80, the CLI and MCP warn the user to update via chrome://extensions. The warning is also surfaced in the MCP agent's warning stream.
4. Fix multi-browser relay collisions — Chromium-based browsers that don't have a signed-in Google account (Chromium, Vivaldi, Helium, Dia, etc.) previously all shared the same browser:Chromium relay key, causing them to replace each other's WebSocket connection. The extension now persists a per-install ID in chrome.storage.local and uses it as a stable fallback key.
5. Fix extension takeover loop — after being replaced by another instance, the extension's reconnect loop now waits until the replacement is fully gone before reclaiming the relay slot. Previously it checked activeTargets === 0, which is briefly true right after a fresh replacement connects, causing the old worker to steal the slot back and drop the active Playwright tab.

playwriter@0.0.103

1. Auto-returned Playwright handles are now silently skipped — await page.goto(url) and similar single-expression code no longer prints anything when the return value is a Playwright handle (Response, Page, Browser, Request, Frame, etc.). These are programmatic references, not display data. The previous behavior also leaked every process.env variable (API keys, tokens, credentials) via util.inspect at depth 4.

   By default expression results are printed and that was the cause — now we don't print those objects which would also waste LLM context.

   To see data, explicitly return specific fields or use console.log:

   123return response.url()           // prints the URL
   return response.status()        // prints 200
   console.log(response)           // prints safe summary

2. console.log(response) now renders a clean summary (via @xmorse/playwright-core@1.59.7) — no env var dump, no 400K+ output:

   1Response@response@abc123 { url: 'https://...', status: 200, statusText: 'OK', headers: [...] }

playwriter@0.0.102

1. Direct CDP connection mode (--direct) — connect to Chrome's built-in debugging WebSocket without needing the Playwriter extension. Works with any Chromium-based browser (Chrome, Brave, Ghost Browser, Arc, Edge, etc.) that has debugging enabled via chrome://inspect/#remote-debugging or --remote-debugging-port. Auto-discovers instances via DevToolsActivePort files and port scanning. For MCP, set PLAYWRITER_DIRECT=1 env var.

   12playwriter session new --direct
   playwriter browser list

   In direct mode, browser.contexts() gives access to pages across all open Chrome profiles.
2. playwriter browser start (experimental) — launched a managed Chrome instance with the bundled Playwriter extension preloaded, useful for fresh VPS/AVPS setups. Now deprecated in favor of session new --direct. The command still works but is hidden from --help.
3. Kitty Graphics Protocol support — when AGENT_GRAPHICS=kitty is set, the CLI emits screenshots and resized images as Kitty Graphics Protocol escape sequences. Agents with kitty-graphics-agent automatically extract images and pass them to the LLM as media parts.

   1AGENT_GRAPHICS=kitty playwriter -s 1 -e "await screenshot({ page })"

4. Screenshots and images now use PNG — screenshotWithAccessibilityLabels() and resizeImageForAgent() now consistently output PNG instead of JPEG, fixing image/png vs image/jpeg mismatch errors in MCP clients.
5. resizeImageForAgent — renamed from resizeImage. Resized images are now automatically collected and included in responses. The old name still works as a backward-compatible alias.
6. Chrome 136+ direct CDP discovery — --direct auto-discovery now detects Chrome instances where /json/version returns 404 (Chrome 136+ with chrome://inspect debugging). Uses HTTP-only probing and never triggers Chrome's approval dialog.
7. Show session cwd in playwriter session list — session table now includes the working directory, making it easier to tell similar sessions apart.
8. Fix session cwd leakage across relay restarts — relative fs paths in the sandbox now resolve from the cwd captured by session new.
9. Contenteditable detection in snapshots — bare contenteditable elements are now correctly detected as interactive textboxes in accessibility snapshots.
10. PLAYWRITER_DIRECT only accepts '1' — removed 'auto' and 'true' aliases. Explicit ws:// endpoints still work.

playwriter@0.0.89

1. More reliable downloads in extension mode: download behavior now stays compatible with both Page.download* and Browser.download* event paths, so flows like page.waitForEvent('download') work consistently through the relay.
2. Default action timeout is now 60 seconds, which reduces false click failures on slower real-world pages when interactions succeed but post-action waiting exceeds short budgets.
3. Ghost cursor injection is more stable for recording flows by using direct per-page injection instead of the unreliable init-script persistence path.

playwriter@0.0.80

1. Ghost cursor overlay during recording — smooth animated cursor visualizes automated mouse actions (clicks, moves, presses) directly on the page during screen recordings, driven by Playwright onMouseAction callbacks so both page.mouse.* and locator.click() are captured
2. Demo video creation — new createDemoVideo() automatically detects and speeds up idle sections between interactions, with hardware encoder detection (h264_videotoolbox, etc.) and optimized FFmpeg output for social media
3. resizeImage() sandbox utility — shrink screenshots before feeding them to LLMs; default mode fits within 1568×1568px, supports explicit width/height/maxDimension
4. Descriptive click timeout errors — when locator.click() times out, the error now explains why ("Element is not visible", "Element is not stable", etc.) instead of a generic timeout message
5. Faster action timeouts — default Playwright action timeout reduced from 10s to 2s so agents get fast failures with descriptive errors; navigation timeout unchanged at 10s
6. State-aware page-close warnings — executor warns when a closed page is referenced in session state and reports which state key(s) need reassignment, with automatic fallback to another open tab
7. Popup detection warnings — executor emits [WARNING] when popup windows open during execution so agents are aware of context changes
8. recording and ghostCursor namespaces — cleaner API in the execute sandbox: recording.start/stop/isRecording/cancel and ghostCursor.show/hide, with backward-compatible top-level aliases
9. Multi-profile Chrome support — auto-selects the correct extension when multiple Chrome profiles are connected simultaneously
10. Snapshot diff scoped by locator — showDiffSinceLastCall cache now isolated per locator scope; also skipped automatically when search is provided
11. Relay state centralized to Zustand store — internal relay state (extensions, targets, playwright clients) unified in a single immutable atom, eliminating scattered Maps and fixing edge-case reconnect bugs
12. page.onMouseAction callback in Playwright fork — fires for both page.mouse.* and locator.click() actions; Locator.selector() now publicly typed (@xmorse/playwright-core@1.59.6)
13. Suppress stack traces for timeout/abort errors — CLI and MCP output is cleaner; only the message is shown for expected timeout failures

playwriter@0.0.63

Security

• Harden privileged HTTP routes against cross-origin attacks: Added route-level middleware on /cli/* and /recording/* that blocks cross-origin browser requests via Sec-Fetch-Site header validation, rejects POST requests without Content-Type: application/json (prevents the CORS preflight bypass via text/plain), and enforces token authentication when token mode is enabled. Previously, CORS alone was relied upon, but CORS only blocks reading responses — it does not prevent "simple" POST requests from executing side effects like /cli/execute.
• Token enforcement on HTTP routes: When --token is set (remote access mode), /cli/* and /recording/* routes now require Authorization: Bearer <token> or ?token=<token>, matching the behavior already documented in remote-access.md.
• Security regression tests: Added tests covering Sec-Fetch-Site blocking, Content-Type enforcement, token validation on privileged routes, and pass-through for legitimate Node.js clients.

playwriter@0.0.62

Features

• Remote access support: PLAYWRITER_HOST now accepts full URLs (e.g., https://x-tunnel.traforo.dev) in addition to plain hostnames, enabling secure remote browser access through tunnels like traforo
• WebSocket over HTTPS: Automatically uses wss:// protocol when connecting to HTTPS relay hosts
• Remote access documentation: Added comprehensive guide covering architecture, setup, use cases, and security model for remote Playwriter access

Internal

• Centralized host parsing: New parseRelayHost() utility handles URL/hostname detection and returns correct HTTP/WebSocket base URLs

playwriter@0.0.61

Improvements

• Simplified Unix port killing: Replaced shell pipeline approach (lsof/grep/awk/xargs) with direct lsof -t for PID discovery and process.kill() for termination. This eliminates spawn overhead and makes the code more maintainable while improving reliability.

@xmorse/playwright-core@1.59.3

• Fix missing runtime dependencies for lockfile.js: add graceful-fs, retry, and signal-exit to package.json dependencies
• Fixes "Cannot find module 'graceful-fs'" error on clean npx playwriter installs (GitHub #45)

playwriter@0.0.59

Bug Fixes

• Fix 'Cannot find module graceful-fs' error: Updated @xmorse/playwright-core to 1.59.3 which adds missing runtime dependencies (graceful-fs, retry, signal-exit) for clean npx playwriter installs (GitHub #45)

playwriter@0.0.58

• Fix bunx playwriter@latest relay restarts by replacing kill-port-process with a vendored cross-platform port killer.
• Harden relay/test/serve port cleanup by routing all kills through local killPortProcess({ port }) on Windows, macOS, and Linux.
• Remove kill-port-process dependency and its transitive process-management packages from the lockfile.
• thanks @remorses for the contributions.

extension@0.0.71

Bug Fixes

• Route Runtime.enable to child CDP sessions: Runtime enable/disable now uses the incoming sessionId when targeting OOPIF child sessions instead of always using the tab root session. This fixes missing Runtime.executionContextCreated events for child iframe targets, which could cause iframe locator operations to hang.

playwriter@0.0.57

Features

• Ghost Browser Support: Added integration with Ghost Browser APIs (multi-identity, proxies)
• Multi-browser Support: Added support for connecting to multiple browser instances/extensions
• Screen Recording: Added concurrent screen recording support in MP4 format (requires extension update)
• Iframe Handling: Improved iframe targeting using Frame objects and Runtime.enable routing
• Accessibility Snapshots: Added support for inline locators and better filtering
• CDP JSONL Logging: Added structured CDP logging to ~/.playwriter/cdp.jsonl

Bug Fixes

• Fix hung navigations on YouTube and similar sites: Resume filtered targets (like service workers) to avoid blocking navigations
• Fix tab group infinite loop: Prevent infinite loop when dragging tabs
• Fix log dir permissions on shared machines: Move default log directory from /tmp/playwriter to ~/.playwriter so each OS user gets their own directory. Fixes startup crash when /tmp/playwriter is owned by another user (#44).

playwriter@0.0.56

Bug Fixes

• Fix hung navigations on YouTube and similar sites: Resume filtered targets (like service workers) to avoid blocking navigations. CDP Target.setAutoAttach with waitForDebuggerOnStart: true requires calling Runtime.runIfWaitingForDebugger even on targets we filter out, otherwise they hang forever.
• Fix auto-enable page selection when no pages: Properly handles the case when there are no existing pages during auto-enable

Features

• CDP JSONL logging: Added structured CDP logging to a JSONL file (/tmp/playwriter/cdp.jsonl) for debugging. Log all CDP messages with direction, timestamp, and source info. Use jq to analyze.
• Sync tab state for automated tabs: Tab state is now properly synced for programmatically created tabs

Improvements

• Better logging output: Use util.inspect for cleaner log output with proper object formatting
• Set default timeout: Added sensible default timeouts for operations

playwriter@0.0.55

Features

• playwriter skill CLI command: New command that prints full MCP instructions to stdout, useful for agents that need up-to-date documentation without relying on MCP resources

Internal

• Moved SKILL.md to src/ - source of truth for agent instructions now lives in src/skill.md
• Removed docker.package.json - cleaned up unused Docker configuration

playwriter@0.0.54

Features

• Faster aria snapshot ref lookup: Refs are now extracted directly from the snapshot string and fetched in parallel (20 concurrent requests), significantly reducing time to generate accessibility snapshots with labels
• refFilter parameter for getAriaSnapshot: New optional filter to include only specific refs by role/name, reducing unnecessary ref lookups
• Increased default execution timeout: Execution timeout increased from 5s to 10s for better handling of slow operations

Bug Fixes

• Pass cwd to executor in MCP: File operations in executed code now use the correct working directory

playwriter@0.0.53

Bug Fixes

• Fix CLI relay server startup from source: Detect source vs compiled via __filename.endsWith('.ts') instead of env var, fixing tsx and vite-node execution
• Wait for extension to reconnect: CLI now waits up to 10 seconds for extension to reconnect after server (re)start before executing commands

Improvements

• Colored CLI output: Setup messages now use colors (dim for progress, green for success, yellow for warnings)

playwriter@0.0.52

Features

• First extension keeps connection: When multiple Playwriter extensions are installed (e.g., dev and prod), the first one with active tabs now keeps the connection instead of being replaced by newer connections. Idle extensions (no tabs) can still be replaced.
• Smarter extension slot detection: /extension/status endpoint now returns activeTargets count, allowing extensions to know when the slot becomes available (no active tabs).
• Accessibility snapshot format options: accessibilitySnapshot now supports format option ('yaml' or 'markdown') with deduplication of interactive refs
• Session management CLI commands: New CLI commands for managing relay sessions (playwriter sessions list, playwriter sessions kill)
• Eval CLI flag: New -e/--eval CLI flag for quick code execution from command line
• Auto-enable environment variable: CLI now passes PLAYWRITER_AUTO_ENABLE when starting relay server

Bug Fixes

• Relay server auto-recovery: Restored auto-recovery on every execute call
• Preserve tabs during relay reconnects: Tabs now persist correctly when relay reconnects
• Show log file path on connection refused error: Better debugging experience with log file location in errors
• Improved error messages for extension connection states: Clearer error messages when extension isn't connected

Security

• Block browser access to CLI endpoints: Prevents browsers from accessing CLI-specific endpoints

Internal

• SKILL.md as source of truth: Refactored to generate prompt.md from SKILL.md
• Aria snapshot module: New aria-snapshot.ts with dedicated accessibility snapshot functions

playwriter@0.0.50

Bug Fixes

• Sharp fallback with viewport clipping: When sharp is unavailable (optional dependency), screenshots now clip to max 1568px instead of relying on Claude's auto-resize
• Error logging for sharp failures: Added logging when sharp import or resize fails, making it easier to debug screenshot optimization issues

playwriter@0.0.49

Features

• CORS support for relay server: Added CORS middleware to allow extension's fetch/XHR requests during development. Only allows requests from our specific extension IDs for security.

Bug Fixes

• Clearer error messages: Improved error messages when another Playwriter extension connects, making it easier to diagnose connection issues

playwriter@0.0.48

Bug Fixes

• Fix SSE streaming (issue #22): CDP's Network domain buffers response bodies by default, which breaks SSE/streaming - data arrives at Chrome but ReadableStream never receives it. Now Network.enable defaults to maxTotalBufferSize: 0 to disable buffering.

Features

• Auto-switch to another page when default page is closed: When the current page is closed, MCP automatically switches to another available page instead of erroring
• Optimized screenshot token usage: Screenshots are now resized with sharp to reduce Claude token consumption
• Reading response bodies: Agents can re-enable Network buffering via Network.disable + Network.enable with explicit buffer sizes when they need response.body()

Changes

• Dependencies cleanup: Removed unused deps, updated to zod v4, replaced chalk with picocolors

playwriter@0.0.47

Bug Fixes

• Improved connection reliability: Use 127.0.0.1 instead of localhost to avoid DNS/IPv6 resolution issues, add 15s global timeout wrapper around connect() to prevent hanging forever
• Use domcontentloaded everywhere: Changed getCurrentPage() and prompt guidance to use domcontentloaded instead of load for faster, more reliable page detection
• Allow attaching to own extension pages: Extension pages can now be debugged while still blocking other extensions

Changes

• Centralized target filtering: Consolidated extension ID arrays and target filtering logic for cleaner code
• Optional wsUrl in getCDPSessionForPage: wsUrl parameter now defaults to getCdpUrl() if not provided

playwriter@0.0.46

Bug Fixes

• Limit screenshot dimensions to 2000px: Screenshots are now clipped to max 2000x2000 pixels to avoid Claude API rejection for many-image requests (Claude enforces 2000px limit when >20 images in a request)

playwriter@0.0.45

Bug Fixes

• Filter non-page targets from Playwright (issue #14): Service workers, web workers, and other non-page targets are now filtered out at the server level. This prevents Playwright from trying to initialize these targets, which would cause timeouts waiting for executionContextCreated events and errors on Target.detachFromTarget.

playwriter@0.0.44

Features

• Search context lines: accessibilitySnapshot, getCleanHTML, and getLatestLogs now include 5 lines of context above and below each search match

  • Non-contiguous sections are separated by ---
  • Provides better context for understanding search results

playwriter@0.0.43

Features

• getCleanHTML utility: New function to get cleaned HTML from a locator or page

  • Removes script, style, svg, head tags
  • Keeps only essential attributes (aria-, data-, href, role, title, alt, etc.)
  • Supports search option to filter results (returns first 10 matching lines)
  • Supports showDiffSinceLastCall to see changes since last snapshot
  • Supports includeStyles to optionally keep style/class attributes

Changes

• Simplified accessibilitySnapshot search: Removed contextLines parameter, search now returns just matching lines instead of context around matches. Use .split('\n').slice() for pagination instead.

playwriter@0.0.42

Bug Fixes

• Fix "no low surrogate in string" API error: Sanitize accessibility snapshot text using toWellFormed() to remove unpaired Unicode surrogates that break JSON encoding for Claude API (requires Node.js 20+ for sanitization, gracefully degrades on older versions)

playwriter@0.0.41

Features

• Arrow connectors in screenshot labels: Visual labels now show arrow lines from label to element center, making it clearer which element each label references

Patch Changes

• Bigger label font: Increased label font size from 11px to 12px for better readability
• Fixed screenshot dimensions: Screenshots now use actual viewport size (innerWidth/innerHeight) with scale: 'css' to match visual appearance

playwriter@0.0.40

Features

• screenshotWithAccessibilityLabels: New utility function that takes a screenshot with Vimium-style visual labels overlaid on interactive elements

  • Labels show aria-ref IDs that can be used with page.locator('aria-ref=e5')
  • Image and accessibility snapshot are automatically included in the response
  • Can be called multiple times to capture multiple screenshots
  • Labels are color-coded by element type
• Media elements in aria labels: Added img, video, audio to INTERACTIVE_ROLES

  • Light blue color scheme for media element labels
  • Agents can now reference images by aria-ref for visual tasks

Patch Changes

• Extension fix: Query playwriter tab group by title instead of caching ID, fixing stale group issues after debugger detach/reattach

playwriter@0.0.39

Patch Changes

• Fix icon not updating on WS disconnect: maintainLoop now ensures tabs transition to 'connecting' state when WebSocket is not connected, fixing edge cases where handleClose wasn't called
• Increased aria-labels auto-hide timeout: Labels now auto-hide after 30 seconds instead of 5 seconds

playwriter@0.0.38

Patch Changes

• Internal connection handling improvements