Skip to content

Commit 01b2b15

Browse files
pavelfeldmanpavelfeldman
committed
cherry-pick(#39980): chore: more release notes fixes
1 parent a5cb6c9 commit 01b2b15

4 files changed

Lines changed: 91 additions & 60 deletions

File tree

‎docs/src/release-notes-csharp.md‎

Lines changed: 23 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,12 @@ import LiteYouTube from '@site/src/components/LiteYouTube';
1010

1111
### 🎬 Screencast
1212

13-
New [`property: Page.screencast`] API provides a unified interface for capturing page content — both as video recordings, annotations, overlays, and a real-time frame stream.
13+
New [`property: Page.screencast`] API provides a unified interface for capturing page content with:
14+
- Screencast recordings
15+
- Action annotations
16+
- Visual overlays
17+
- Real-time frame capture
18+
- Agentic video receipts
1419

1520
<center>
1621
<img src="https://raw.githubusercontent.com/microsoft/playwright/main/docs/src/images/release-notes-1.59-screencast-demo.gif" alt="Demo" width="500" height="313" />
@@ -25,14 +30,6 @@ await page.Screencast.StartAsync(new() { Path = "video.webm" });
2530
await page.Screencast.StopAsync();
2631
```
2732

28-
**Real-time frame capture** — stream JPEG-encoded frames for custom processing like thumbnails, live previews, AI vision, and more:
29-
30-
```csharp
31-
await page.Screencast.StartAsync(new() {
32-
OnFrame = frame => SendToVisionModel(frame.Data),
33-
});
34-
```
35-
3633
**Action annotations** — enable built-in visual annotations that highlight interacted elements and display action titles during recording:
3734

3835
```csharp
@@ -52,6 +49,14 @@ await page.Screencast.ShowChapterAsync("Adding TODOs", new() {
5249
await page.Screencast.ShowOverlayAsync("<div style=\"color: red\">Recording</div>");
5350
```
5451

52+
**Real-time frame capture** — stream JPEG-encoded frames for custom processing like thumbnails, live previews, AI vision, and more:
53+
54+
```csharp
55+
await page.Screencast.StartAsync(new() {
56+
OnFrame = frame => SendToVisionModel(frame.Data),
57+
});
58+
```
59+
5560
**Agentic video receipts** — coding agents can produce video evidence of their work. After completing a task, an agent can record a walkthrough video with rich annotations for human review:
5661

5762
```csharp
@@ -116,25 +121,25 @@ New [`method: Browser.bind`] API makes a launched browser available for `playwri
116121
**Bind a browser** — start a browser and bind it so others can connect:
117122

118123
```csharp
119-
var browser = await chromium.LaunchAsync();
120124
var serverInfo = await browser.BindAsync("my-session", new() {
121125
WorkspaceDir = "/my/project",
122126
});
123127
```
124128

125-
**Connect from playwright-cli**
129+
**Connect from playwright-cli** — connect to the running browser from your favorite coding agent.
126130

127131
```bash
128132
playwright-cli attach my-session
133+
playwright-cli -s my-session snapshot
129134
```
130135

131-
**Connect from playwright/mcp**
136+
**Connect from @playwright/mcp** — or point your MCP server to the running browser.
132137

133138
```bash
134139
@playwright/mcp --endpoint=my-session
135140
```
136141

137-
**Connect from another client**
142+
**Connect from a Playwright client** — use API to connect to the browser. Multiple clients at a time are supported!
138143

139144
```csharp
140145
var browser = await chromium.ConnectAsync(serverInfo.Endpoint);
@@ -154,10 +159,13 @@ Call [`method: Browser.unbind`] to stop accepting new connections.
154159

155160
### 📊 Observability
156161

157-
Run `playwright-cli show` to open the Dashboard that lists all bound browsers, their status, and workspace.
162+
Run `playwright-cli show` to open the Dashboard that lists all the bound browsers, their statuses, and allows interacting with them:
163+
- See what your agent is doing on the background browsers
164+
- Click into the sessions for manual interventions
165+
- Open DevTools to inspect pages from the background browsers.
158166

159167
<center>
160-
<img src="https://raw.githubusercontent.com/microsoft/playwright/main/docs/src/images/release-notes-1.59-dashboard.gif" alt="Demo" width="1169" height="835" />
168+
<img src="https://raw.githubusercontent.com/microsoft/playwright/main/docs/src/images/release-notes-1.59-dashboard.png" alt="Demo" width="1169" height="835" />
161169
</center>
162170

163171
- `playwright-cli` binds all of its browsers automatically, so you can see what your agents are doing.

‎docs/src/release-notes-java.md‎

Lines changed: 22 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,12 @@ import LiteYouTube from '@site/src/components/LiteYouTube';
1010

1111
### 🎬 Screencast
1212

13-
New [`property: Page.screencast`] API provides a unified interface for capturing page content — both as video recordings, annotations, overlays, and a real-time frame stream.
13+
New [`property: Page.screencast`] API provides a unified interface for capturing page content with:
14+
- Screencast recordings
15+
- Action annotations
16+
- Visual overlays
17+
- Real-time frame capture
18+
- Agentic video receipts
1419

1520
<center>
1621
<img src="https://raw.githubusercontent.com/microsoft/playwright/main/docs/src/images/release-notes-1.59-screencast-demo.gif" alt="Demo" width="500" height="313" />
@@ -25,13 +30,6 @@ page.screencast().start(new Screencast.StartOptions().setPath(Paths.get("video.w
2530
page.screencast().stop();
2631
```
2732

28-
**Real-time frame capture** — stream JPEG-encoded frames for custom processing like thumbnails, live previews, AI vision, and more:
29-
30-
```java
31-
page.screencast().start(new Screencast.StartOptions()
32-
.setOnFrame(frame -> sendToVisionModel(frame.data)));
33-
```
34-
3533
**Action annotations** — enable built-in visual annotations that highlight interacted elements and display action titles during recording:
3634

3735
```java
@@ -51,6 +49,13 @@ page.screencast().showChapter("Adding TODOs",
5149
page.screencast().showOverlay("<div style=\"color: red\">Recording</div>");
5250
```
5351

52+
**Real-time frame capture** — stream JPEG-encoded frames for custom processing like thumbnails, live previews, AI vision, and more:
53+
54+
```java
55+
page.screencast().start(new Screencast.StartOptions()
56+
.setOnFrame(frame -> sendToVisionModel(frame.data)));
57+
```
58+
5459
**Agentic video receipts** — coding agents can produce video evidence of their work. After completing a task, an agent can record a walkthrough video with rich annotations for human review:
5560

5661
```java
@@ -116,24 +121,24 @@ New [`method: Browser.bind`] API makes a launched browser available for `playwri
116121
**Bind a browser** — start a browser and bind it so others can connect:
117122

118123
```java
119-
Browser browser = chromium.launch();
120124
Browser.BindResult serverInfo = browser.bind("my-session",
121125
new Browser.BindOptions().setWorkspaceDir("/my/project"));
122126
```
123127

124-
**Connect from playwright-cli**
128+
**Connect from playwright-cli** — connect to the running browser from your favorite coding agent.
125129

126130
```bash
127131
playwright-cli attach my-session
132+
playwright-cli -s my-session snapshot
128133
```
129134

130-
**Connect from playwright/mcp**
135+
**Connect from @playwright/mcp** — or point your MCP server to the running browser.
131136

132137
```bash
133138
@playwright/mcp --endpoint=my-session
134139
```
135140

136-
**Connect from another client**
141+
**Connect from a Playwright client** — use API to connect to the browser. Multiple clients at a time are supported!
137142

138143
```java
139144
Browser browser = chromium.connect(serverInfo.endpoint);
@@ -151,10 +156,13 @@ Call [`method: Browser.unbind`] to stop accepting new connections.
151156

152157
### 📊 Observability
153158

154-
Run `playwright-cli show` to open the Dashboard that lists all bound browsers, their status, and workspace.
159+
Run `playwright-cli show` to open the Dashboard that lists all the bound browsers, their statuses, and allows interacting with them:
160+
- See what your agent is doing on the background browsers
161+
- Click into the sessions for manual interventions
162+
- Open DevTools to inspect pages from the background browsers.
155163

156164
<center>
157-
<img src="https://raw.githubusercontent.com/microsoft/playwright/main/docs/src/images/release-notes-1.59-dashboard.gif" alt="Demo" width="1169" height="835" />
165+
<img src="https://raw.githubusercontent.com/microsoft/playwright/main/docs/src/images/release-notes-1.59-dashboard.png" alt="Demo" width="1169" height="835" />
158166
</center>
159167

160168
- `playwright-cli` binds all of its browsers automatically, so you can see what your agents are doing.

‎docs/src/release-notes-js.md‎

Lines changed: 23 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,12 @@ import LiteYouTube from '@site/src/components/LiteYouTube';
1010

1111
### 🎬 Screencast
1212

13-
New [`property: Page.screencast`] API provides a unified interface for capturing page content — both as video recordings, annotations, overlays, and a real-time frame stream.
13+
New [`property: Page.screencast`] API provides a unified interface for capturing page content with:
14+
- Screencast recordings
15+
- Action annotations
16+
- Visual overlays
17+
- Real-time frame capture
18+
- Agentic video receipts
1419

1520
<center>
1621
<img src="https://raw.githubusercontent.com/microsoft/playwright/main/docs/src/images/release-notes-1.59-screencast-demo.gif" alt="Demo" width="500" height="313" />
@@ -25,15 +30,6 @@ await page.screencast.start({ path: 'video.webm' });
2530
await page.screencast.stop();
2631
```
2732

28-
**Real-time frame capture** — stream JPEG-encoded frames for custom processing like thumbnails, live previews, AI vision, and more:
29-
30-
```js
31-
await page.screencast.start({
32-
onFrame: ({ data }) => sendToVisionModel(data),
33-
size: { width: 800, height: 600 },
34-
});
35-
```
36-
3733
**Action annotations** — enable built-in visual annotations that highlight interacted elements and display action titles during recording:
3834

3935
```js
@@ -70,6 +66,15 @@ await page.screencast.showChapter('Adding TODOs', {
7066
await page.screencast.showOverlay('<div style="color: red">Recording</div>');
7167
```
7268

69+
**Real-time frame capture** — stream JPEG-encoded frames for custom processing like thumbnails, live previews, AI vision, and more:
70+
71+
```js
72+
await page.screencast.start({
73+
onFrame: ({ data }) => sendToVisionModel(data),
74+
size: { width: 800, height: 600 },
75+
});
76+
```
77+
7378
**Agentic video receipts** — coding agents can produce video evidence of their work. After completing a task, an agent can record a walkthrough video with rich annotations for human review:
7479

7580
```js
@@ -101,26 +106,25 @@ New [`method: Browser.bind`] API makes a launched browser available for `playwri
101106
**Bind a browser** — start a browser and bind it so others can connect:
102107

103108
```js
104-
const browser = await chromium.launch();
105109
const { endpoint } = await browser.bind('my-session', {
106110
workspaceDir: '/my/project',
107111
});
108112
```
109113

110-
**Connect from playwright-cli**
114+
**Connect from playwright-cli** — connect to the running browser from your favorite coding agent.
111115

112116
```bash
113117
playwright-cli attach my-session
114118
playwright-cli -s my-session snapshot
115119
```
116120

117-
**Connect from playwright/mcp**
121+
**Connect from @playwright/mcp** — or point your MCP server to the running browser.
118122

119123
```bash
120124
@playwright/mcp --endpoint=my-session
121125
```
122126

123-
**Connect from another client**
127+
**Connect from a Playwright client** — use API to connect to the browser. Multiple clients at a time are supported!
124128

125129
```js
126130
const browser = await chromium.connect(endpoint);
@@ -140,10 +144,13 @@ Call [`method: Browser.unbind`] to stop accepting new connections.
140144

141145
### 📊 Observability
142146

143-
Run `playwright-cli show` to open the Dashboard that lists all bound browsers, their status, and workspace.
147+
Run `playwright-cli show` to open the Dashboard that lists all the bound browsers, their statuses, and allows interacting with them:
148+
- See what your agent is doing on the background browsers
149+
- Click into the sessions for manual interventions
150+
- Open DevTools to inspect pages from the background browsers.
144151

145152
<center>
146-
<img src="https://raw.githubusercontent.com/microsoft/playwright/main/docs/src/images/release-notes-1.59-dashboard.gif" alt="Demo" width="1169" height="835" />
153+
<img src="https://raw.githubusercontent.com/microsoft/playwright/main/docs/src/images/release-notes-1.59-dashboard.png" alt="Demo" width="1169" height="835" />
147154
</center>
148155

149156
- `playwright-cli` binds all of its browsers automatically, so you can see what your agents are doing.

‎docs/src/release-notes-python.md‎

Lines changed: 23 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,12 @@ import LiteYouTube from '@site/src/components/LiteYouTube';
1010

1111
### 🎬 Screencast
1212

13-
New [`property: Page.screencast`] API provides a unified interface for capturing page content — both as video recordings, annotations, overlays, and a real-time frame stream.
13+
New [`property: Page.screencast`] API provides a unified interface for capturing page content with:
14+
- Screencast recordings
15+
- Action annotations
16+
- Visual overlays
17+
- Real-time frame capture
18+
- Agentic video receipts
1419

1520
<center>
1621
<img src="https://raw.githubusercontent.com/microsoft/playwright/main/docs/src/images/release-notes-1.59-screencast-demo.gif" alt="Demo" width="500" height="313" />
@@ -25,14 +30,6 @@ page.screencast.start(path="video.webm")
2530
page.screencast.stop()
2631
```
2732

28-
**Real-time frame capture** — stream JPEG-encoded frames for custom processing like thumbnails, live previews, AI vision, and more:
29-
30-
```python
31-
page.screencast.start(
32-
on_frame=lambda frame: send_to_vision_model(frame["data"]),
33-
)
34-
```
35-
3633
**Action annotations** — enable built-in visual annotations that highlight interacted elements and display action titles during recording:
3734

3835
```python
@@ -52,6 +49,14 @@ page.screencast.show_chapter("Adding TODOs",
5249
page.screencast.show_overlay('<div style="color: red">Recording</div>')
5350
```
5451

52+
**Real-time frame capture** — stream JPEG-encoded frames for custom processing like thumbnails, live previews, AI vision, and more:
53+
54+
```python
55+
page.screencast.start(
56+
on_frame=lambda frame: send_to_vision_model(frame["data"]),
57+
)
58+
```
59+
5560
**Agentic video receipts** — coding agents can produce video evidence of their work. After completing a task, an agent can record a walkthrough video with rich annotations for human review:
5661

5762
```python
@@ -116,25 +121,25 @@ New [`method: Browser.bind`] API makes a launched browser available for `playwri
116121
**Bind a browser** — start a browser and bind it so others can connect:
117122

118123
```python
119-
browser = await chromium.launch()
120124
server_info = await browser.bind("my-session",
121125
workspace_dir="/my/project",
122126
)
123127
```
124128

125-
**Connect from playwright-cli**
129+
**Connect from playwright-cli** — connect to the running browser from your favorite coding agent.
126130

127131
```bash
128132
playwright-cli attach my-session
133+
playwright-cli -s my-session snapshot
129134
```
130135

131-
**Connect from playwright/mcp**
136+
**Connect from @playwright/mcp** — or point your MCP server to the running browser.
132137

133138
```bash
134139
@playwright/mcp --endpoint=my-session
135140
```
136141

137-
**Connect from another client**
142+
**Connect from a Playwright client** — use API to connect to the browser. Multiple clients at a time are supported!
138143

139144
```python
140145
browser = await chromium.connect(server_info["endpoint"])
@@ -154,10 +159,13 @@ Call [`method: Browser.unbind`] to stop accepting new connections.
154159

155160
### 📊 Observability
156161

157-
Run `playwright-cli show` to open the Dashboard that lists all bound browsers, their status, and workspace.
162+
Run `playwright-cli show` to open the Dashboard that lists all the bound browsers, their statuses, and allows interacting with them:
163+
- See what your agent is doing on the background browsers
164+
- Click into the sessions for manual interventions
165+
- Open DevTools to inspect pages from the background browsers.
158166

159167
<center>
160-
<img src="https://raw.githubusercontent.com/microsoft/playwright/main/docs/src/images/release-notes-1.59-dashboard.gif" alt="Demo" width="1169" height="835" />
168+
<img src="https://raw.githubusercontent.com/microsoft/playwright/main/docs/src/images/release-notes-1.59-dashboard.png" alt="Demo" width="1169" height="835" />
161169
</center>
162170

163171
- `playwright-cli` binds all of its browsers automatically, so you can see what your agents are doing.

0 commit comments

Comments
 (0)