playwriter
Code Issues

update agents

Browse Source
This commit is contained in:
Tommy D. Rossi
2026-01-13 00:13:19 +01:00
parent 1dcfee7eab
commit 3ae65a2dd6
2 changed files with 25 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files
PLAYWRITER_AGENTS.md
+5 -5
View File
@@ -1,4 +1,4 @@
this codebase has the codebase for playwriter
this is the playwriter codebase
the extension uses chrome.debugger to manage the user browser
@@ -12,7 +12,7 @@ breaking changes to the WS protocol MUST never be made. publishing the extension
## architecture
- user installs the extension in chrome. we assume there is only one chrome window for now, the first opened.
- extension connects to a websocket server. on 19988. if this server is still not open, it retries connecting in a loop
- extension connects to a websocket server on port 19988. if this server is not yet open, it retries connecting in a loop
- the MCP spawns the ws server if not already listening on 19988, in background. the mcp then connects to this same server with a playwright client
- the server exposes /cdp/client-id which is used by playwright clients to communicate with the extension
- the extension instead connects to /extension which is used to receive cdp commands and send responses and cdp events.
@@ -40,12 +40,12 @@ website/public/resources/ is auto-generated by `playwriter/scripts/build-resourc
## CDP docs
here are some commands you can run to fetch does about CDP various domains (events and commands namespaces)
here are some commands you can run to fetch docs about CDP domains (events and commands namespaces)
```
curl -sL https://raw.githubusercontent.com/ChromeDevTools/devtools-protocol/master/pdl/domains/Target.pdl # manage “targets”: pages, iframes, workers, etc., and attach/detach sessions
curl -sL https://raw.githubusercontent.com/ChromeDevTools/devtools-protocol/master/pdl/domains/Browser.pdl # top-level browser control: version info, window management, permission settings, etc.
curl -sL https://raw.githubusercontent.com/ChromeDevTools/devtools-protocol/master/pdl/domains/Page.pdl – navigate, reload, screenshot, PDF, frame management, dialogs, and page lifecycle events.
curl -sL https://raw.githubusercontent.com/ChromeDevTools/devtools-protocol/master/pdl/domains/Page.pdl # navigate, reload, screenshot, PDF, frame management, dialogs, and page lifecycle events.
curl -sL https://raw.githubusercontent.com/ChromeDevTools/devtools-protocol/master/pdl/domains/Emulation.pdl # emulate device metrics, viewport, timezone, locale, geolocation, media type, CPU, etc.
```
@@ -67,7 +67,7 @@ remember that every time the extension is activated in a tab that tab gets added
to debug server or extension issues you can also inspect the file @playwriter/relay-server.log to see both extension and server logs. with all cdp events sent. to see if there are events missing or something broken. this file is recreated every time the server is started and appended in real time. use rg to only read relevant lines and parts because it can get quite long
IMPORTANT: `pnpm test` will take about 30 seconds so set a timeout of at least 3600ms when running the pnpm test bash command
IMPORTANT: `pnpm test` will take about 30 seconds so set a timeout of at least 60000ms when running the pnpm test bash command
## changelogs