8e0953abc4
feat: add PWA inspection and download tools
...
Add browser_pwa_info (read-only) to detect and report PWA metadata
including manifest, service worker state, and CacheStorage contents.
Add browser_pwa_download to save complete PWA packages with manifest,
icons, service worker scripts, and cached resources to disk.
2026-02-02 19:43:11 -07:00
f8e3abac82
test: update tool snapshot for storage and throttle tools
...
Add 9 new tools to capabilities test:
- browser_get_cookies, browser_set_cookie, browser_delete_cookies
- browser_get_storage, browser_set_storage, browser_clear_storage
- browser_set_network_conditions, browser_get_network_conditions, browser_clear_network_conditions
2026-01-18 17:31:56 -07:00
96641283c3
feat: add WebRTC connection monitoring tools
...
Add real-time WebRTC connection monitoring for testing video calling apps.
Monitors real RTCPeerConnection instances and collects connection statistics.
New tools:
- browser_start_webrtc_monitoring: Enable monitoring and stats collection
- browser_get_webrtc_connections: List connections with state filtering
- browser_get_webrtc_stats: Detailed stats (bitrate, packet loss, jitter, RTT)
- browser_stop_webrtc_monitoring: Stop stats polling, preserve data
- browser_clear_webrtc_data: Clear captured connection data
Implementation:
- Intercepts RTCPeerConnection constructor via page.addInitScript()
- Captures state changes via page.exposeFunction() callbacks
- Collects stats via page.evaluate() calling getStats()
- Tab-level storage with Context aggregation (same pattern as notifications)
- Configurable stats polling interval (default 1s)
Use cases:
- Test WebRTC call quality in real-time
- Monitor connection states and failures
- Analyze bandwidth, packet loss, frame rates
2026-01-16 20:39:44 -07:00
a7d10f71bd
feat: add device orientation and motion sensor mocking tools
...
Add CDP-based sensor mocking tools for testing motion-sensitive web apps:
- browser_set_device_orientation: Override DeviceOrientationEvent values
(compass heading, front-back tilt, left-right tilt)
- browser_clear_device_orientation: Clear orientation override
- browser_set_device_motion: Override accelerometer and gyroscope values
(acceleration, acceleration with gravity, rotation rate)
- browser_clear_device_motion: Clear motion override
These tools use Chrome DevTools Protocol (Chromium only) to mock sensor
readings, enabling testing of AR/VR apps, compass apps, games, and
other motion-sensitive web applications.
Also updates test snapshots to include all new core tools added recently.
2026-01-13 01:18:06 -07:00
Pavel Feldman
601a74305c
chore: introduce response type ( #738 )
2025-07-22 16:36:21 -07:00
Pavel Feldman
468c84eb8f
chore: move state to tab, do not cache snapshot ( #730 )
2025-07-22 07:53:33 -07:00
Pavel Feldman
f1826b96b6
chore: align lint w/ playwright ( #729 )
2025-07-21 17:07:13 -07:00
Copilot
eeeab4f042
fix: browser_take_screenshot to not require snapshot unless element is specified ( #725 )
2025-07-21 10:52:06 -07:00
Copilot
efe3ff0c7c
Add test for browser_evaluate error handling ( #719 )
2025-07-19 20:12:32 -07:00
Pavel Feldman
29711d07d3
chore: use streamable http by default ( #716 )
...
Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
2025-07-18 18:31:00 -07:00
Copilot
1eee30fd45
feat: add fullPage mode to browser_take_screenshot ( #704 )
2025-07-18 13:56:43 -07:00
Copilot
29ac29e6bb
fix: no-sandbox flag logic to only disable sandbox when explicitly passed ( #709 )
2025-07-18 13:56:01 -07:00
Pavel Feldman
5bfff0a059
chore: include recent console logs in results ( #689 )
2025-07-17 14:58:44 -07:00
Pavel Feldman
c97bc6e2ae
chore: allow right click ( #687 )
...
Fixes https://github.com/microsoft/playwright-mcp/issues/467
2025-07-17 13:24:05 -07:00
Pavel Feldman
95454735bf
chore: remove image reply special case in cursor ( #680 )
2025-07-16 18:32:07 -07:00
Pavel Feldman
e9f6433241
chore: remove server experiment ( #681 )
2025-07-16 18:05:47 -07:00
Pavel Feldman
d61aa16fee
chore: turn vision into capability ( #679 )
...
Fixes https://github.com/microsoft/playwright-mcp/issues/420
2025-07-16 16:40:00 -07:00
Pavel Feldman
012c906500
chore: introduce browser_evaluate ( #678 )
...
Fixes https://github.com/microsoft/playwright-mcp/issues/424
2025-07-16 15:02:47 -07:00
Pavel Feldman
825a97d66e
chore: remove generate_test tool for now - it adds no value ( #675 )
2025-07-16 13:33:05 -07:00
Pavel Feldman
3061d9aa56
chore: resolve dialog races ( #673 )
...
Fixes https://github.com/microsoft/playwright-mcp/issues/595
2025-07-16 13:32:54 -07:00
Pavel Feldman
da818d113a
chore: make tab indexes 0-based ( #674 )
...
Fixes https://github.com/microsoft/playwright-mcp/issues/570
2025-07-16 09:55:08 -07:00
Pavel Feldman
a5a57df105
chore: include page errors in console messages ( #671 )
...
Fixes https://github.com/microsoft/playwright-mcp/issues/669
2025-07-15 15:46:09 -07:00
Pavel Feldman
128474b4aa
chore: remove extension code ( #667 )
2025-07-14 10:52:38 -07:00
Pavel Feldman
7fca8f50f8
chore: roll Playwright to 1.54.1 ( #665 )
2025-07-14 09:51:14 -07:00
Simon Knott
841bb417d1
chore: update to 1.54.0 ( #653 )
...
Closes https://github.com/microsoft/playwright-mcp/issues/535
2025-07-14 09:53:33 +02:00
Pavel Feldman
59f1d67a4e
feat(dblclick): add double click ( #654 )
...
Fixes https://github.com/microsoft/playwright-mcp/issues/652
2025-07-11 16:45:39 -07:00
Simon Knott
9066988098
chore: improve "ref not found" error message ( #561 )
...
Helps the model better understand the error cause.
2025-06-17 14:09:29 +02:00
Max Schmitt
6c3f3b6576
feat: add MCP Chrome extension ( #325 )
...
Instructions:
1. `git clone https://github.com/mxschmitt/playwright-mcp && git
checkout extension-drafft`
2. `npm ci && npm run build`
3. `chrome://extensions` in your normal Chrome, "load unpacked" and
select the extension folder.
4. `node cli.js --port=4242 --extension` - The URL it prints at the end
you can put into the extension popup.
5.
Put either this into Claude Desktop (it does not support SSE yet hence
wrapping it or just put the URL into Cursor/VSCode)
```json
{
"mcpServers": {
"playwright": {
"command": "bash",
"args": [
"-c",
"source $HOME/.nvm/nvm.sh && nvm use --silent 22 && npx supergateway --streamableHttp http://127.0.0.1:4242/mcp "
]
}
}
}
```
Things like `Take a snapshot of my browser.` should now work in your
Prompt Chat.
----
- SSE only for now, since we already have a http server with a port
there
- Upstream "page tests" can be executed over this CDP relay via
https://github.com/microsoft/playwright/pull/36286
- Limitations for now are everything what happens outside of the tab its
session is shared with -> `window.open` / `target=_blank`.
---------
Co-authored-by: Yury Semikhatsky <yurys@chromium.org>
2025-06-13 13:15:17 -07:00
Max Schmitt
abbe7858a2
test: add PWMCP_DEBUG env switch ( #523 )
2025-06-05 10:40:03 -07:00
Pavel Feldman
27c498e0e7
chore: rename browser agent to server ( #521 )
2025-06-04 16:43:11 -07:00
Pavel Feldman
0fb9646c4d
chore: experimental agent mode ( #516 )
2025-06-04 09:14:50 -07:00
Simon Knott
9728527900
chore: typo ( #513 )
2025-06-03 11:10:47 -07:00
Pavel Feldman
f31ef598bc
test: verify the log in close/navigate test ( #505 )
2025-06-01 12:49:30 -07:00
Pavel Feldman
656779531c
chore: respect server settings from config ( #502 )
2025-05-30 18:17:51 -07:00
Pavel Feldman
eec177d3ac
chore: reuse browser in server mode ( #495 )
2025-05-30 15:15:37 -07:00
Pavel Feldman
54ed7c3200
chore: refactor server, prepare for browser reuse ( #490 )
2025-05-28 16:55:47 -07:00
Simon Knott
45f493da6c
chore: make library test run under older Node versions ( #479 )
2025-05-27 13:19:25 -07:00
Pavel Feldman
9e5ffd2ccf
fix(cursor): allow enforcing images for cursor --image-responses=allow ( #478 )
...
Fixes https://github.com/microsoft/playwright-mcp/issues/449
2025-05-27 10:25:09 +02:00
Simon Knott
1051ea810a
fix: import from cjs ( #476 )
...
Closes https://github.com/microsoft/playwright-mcp/issues/456
2025-05-26 14:18:03 -07:00
Pavel Feldman
f20ae22ec6
chore: roll Playwright, remove localOutputDir ( #471 )
2025-05-24 11:44:57 -07:00
Simon Knott
13cd1b4bd9
fix: respect browserName in config ( #461 )
...
Resolves https://github.com/microsoft/playwright-mcp/issues/458
2025-05-23 15:13:34 -07:00
Pavel Feldman
1318e39fac
chore: fix operation over cdp ( #440 )
...
Ref https://github.com/microsoft/playwright-mcp/issues/439
2025-05-17 08:20:22 -07:00
Pavel Feldman
c2b7fb29de
chore: start trace server ( #427 )
2025-05-14 20:15:09 -07:00
Pavel Feldman
aa6ac51f92
feat(trace): allow saving trajectory as trace ( #426 )
2025-05-14 18:08:44 -07:00
Pavel Feldman
fea50e6840
chore: introduce resolved config ( #425 )
2025-05-14 16:01:08 -07:00
Pavel Feldman
ee33097abe
chore: normalize --no- options ( #413 )
2025-05-13 16:17:45 -07:00
Pavel Feldman
ce72367208
feat(storage): allow passing storage state for isolated contexts ( #409 )
...
Fixes https://github.com/microsoft/playwright-mcp/issues/403
Ref https://github.com/microsoft/playwright-mcp/issues/367
2025-05-13 13:14:04 -07:00
Pavel Feldman
949f956378
feat(ephemeral): allow for non-persistent context operation ( #405 )
...
Ref: https://github.com/microsoft/playwright-mcp/issues/367
Ref: https://github.com/microsoft/playwright-mcp/issues/393
2025-05-12 18:18:53 -07:00
Pavel Feldman
dd5b41f1d8
chore: account for undefined arguments ( #400 )
2025-05-12 09:35:33 -07:00
Max Schmitt
84664d4b09
test: unflake 'should throw connection error and allow re-connecting' ( #398 )
...
Fixes
https://github.com/microsoft/playwright-mcp/actions/runs/14940263450/job/41976152764#step:8:315
2025-05-12 09:45:09 +02:00
