chore: roll driver to 1.60.0-alpha-2026-03-31 (#3292)

Author: dgozman

src/Common/Version.props

@@ -2,7 +2,7 @@
   <PropertyGroup>
     <AssemblyVersion>1.58.0</AssemblyVersion>
     <PackageVersion>$(AssemblyVersion)</PackageVersion>
-    <DriverVersion>1.59.0-alpha-1774622285000</DriverVersion>
+    <DriverVersion>1.60.0-alpha-2026-03-31</DriverVersion>
     <ReleaseVersion>$(AssemblyVersion)</ReleaseVersion>
     <FileVersion>$(AssemblyVersion)</FileVersion>
     <NoDefaultExcludes>true</NoDefaultExcludes>

src/Playwright.TestingHarnessTest/package-lock.json

@@ -2,7 +2,7 @@
   "name": "playwright.testingharnesstest",
   "private": true,
   "devDependencies": {
-    "@playwright/test": "1.59.0-alpha-1774622285000",
+    "@playwright/test": "1.60.0-alpha-2026-03-31",
     "@types/node": "^22.12.0",
     "fast-xml-parser": "^4.5.0"
   }

src/Playwright.TestingHarnessTest/package.json

@@ -127,48 +127,6 @@ public async Task ShouldExposeVideoPathBlankPage()
         Assert.True(new FileInfo(path).Exists);
     }
 
-    [PlaywrightTest("screencast.spec.ts", "should expose video path blank popup")]
-    [Ignore("We don't need to test video details")]
-    public void ShouldExposeVideoPathBlankPopup()
-    {
-    }
-
-    [PlaywrightTest("screencast.spec.ts", "should capture navigation")]
-    [Ignore("We don't need to test video details")]
-    public void ShouldCaptureNavigation()
-    {
-    }
-
-    [PlaywrightTest("screencast.spec.ts", "should capture css transformation")]
-    [Ignore("We don't need to test video details")]
-    public void ShouldCaptureCssTransformation()
-    {
-    }
-
-    [PlaywrightTest("screencast.spec.ts", "should work for popups")]
-    [Ignore("We don't need to test video details")]
-    public void ShouldWorkForPopups()
-    {
-    }
-
-    [PlaywrightTest("screencast.spec.ts", "should scale frames down to the requested size")]
-    [Ignore("We don't need to test video details")]
-    public void ShouldScaleFramesDownToTheRequestedSize()
-    {
-    }
-
-    [PlaywrightTest("screencast.spec.ts", "should use viewport as default size")]
-    [Ignore("We don't need to test video details")]
-    public void ShouldUseViewportAsDefaultSize()
-    {
-    }
-
-    [PlaywrightTest("screencast.spec.ts", "should be 1280x720 by default")]
-    [Ignore("We don't need to test video details")]
-    public void ShouldBe1280x720ByDefault()
-    {
-    }
-
     [PlaywrightTest("screencast.spec.ts", "should capture static page in persistent context")]
     [Skip(SkipAttribute.Targets.Webkit, SkipAttribute.Targets.Firefox)]
     public async Task ShouldCaptureStaticPageInPersistentContext()
@@ -259,4 +217,68 @@ public async Task SaveAsShouldThrowWhenNoVideoFrames()
             StringAssert.Contains("Page did not produce any video frames", exception.Message);
         await context.CloseAsync();
     }
+
+    [PlaywrightTest("screencast.spec.ts", "start throws if screencast is already started")]
+    public async Task StartThrowsIfScreencastIsAlreadyStarted()
+    {
+        var context = await Browser.NewContextAsync(new() { ViewportSize = new() { Width = 500, Height = 400 } });
+        var page = await context.NewPageAsync();
+
+        await page.Screencast.StartAsync(new() { OnFrame = _ => Task.CompletedTask });
+        var exception = await PlaywrightAssert.ThrowsAsync<PlaywrightException>(() =>
+            page.Screencast.StartAsync(new() { OnFrame = _ => Task.CompletedTask }));
+        StringAssert.Contains("Screencast is already started", exception.Message);
+
+        await page.Screencast.StopAsync();
+        await context.CloseAsync();
+    }
+
+    [PlaywrightTest("screencast.spec.ts", "start should record video to file")]
+    public async Task StartShouldRecordVideoToFile()
+    {
+        using var tempDirectory = new TempDirectory();
+        var context = await Browser.NewContextAsync(new()
+        {
+            ViewportSize = new() { Width = 500, Height = 400 }
+        });
+        var page = await context.NewPageAsync();
+
+        var videoPath = Path.Combine(tempDirectory.Path, "video.webm");
+        await page.Screencast.StartAsync(new() { Path = videoPath });
+        await page.EvaluateAsync("() => document.body.style.backgroundColor = 'red'");
+        await Task.Delay(1000);
+        await page.Screencast.StopAsync();
+
+        Assert.True(File.Exists(videoPath));
+        Assert.Greater(new FileInfo(videoPath).Length, 0);
+        await context.CloseAsync();
+    }
+
+    [PlaywrightTest("screencast.spec.ts", "start delivers frames via onFrame callback")]
+    public async Task StartDeliversFramesViaOnFrameCallback()
+    {
+        var context = await Browser.NewContextAsync(new() { ViewportSize = new() { Width = 500, Height = 400 } });
+        var page = await context.NewPageAsync();
+
+        var frames = new List<byte[]>();
+        await page.Screencast.StartAsync(new()
+        {
+            OnFrame = async frame =>
+            {
+                frames.Add(frame.Data);
+            }
+        });
+        await page.EvaluateAsync("() => document.body.style.backgroundColor = 'red'");
+        await Task.Delay(1000);
+        await page.Screencast.StopAsync();
+
+        Assert.Greater(frames.Count, 0);
+        // Each frame must be a valid JPEG (starts with FF D8).
+        foreach (var frame in frames)
+        {
+            Assert.AreEqual(0xFF, frame[0]);
+            Assert.AreEqual(0xD8, frame[1]);
+        }
+        await context.CloseAsync();
+    }
 }

src/Playwright.Tests/ScreencastTests.cs

@@ -44,7 +44,7 @@ public partial interface IDebugger
     /// is not paused.
     /// </para>
     /// </summary>
-    PausedDetail? PausedDetails { get; }
+    DebuggerPausedDetails? PausedDetails { get; }
 
     /// <summary>
     /// <para>Configures the debugger to pause before the next action is executed.</para>

src/Playwright/API/Generated/IDebugger.cs

@@ -1601,8 +1601,6 @@ public partial interface IPage
 
     public IMouse Mouse { get; }
 
-    public IOverlay Overlay { get; }
-
     /// <summary>
     /// <para>
     /// Returns the opener for popup pages and <c>null</c> for others. If the opener has
@@ -3034,12 +3032,11 @@ public partial interface IPage
 
     /// <summary>
     /// <para>
-    /// Video object associated with this page. Can be used to control video recording with
-    /// <see cref="IVideo.StartAsync"/> and <see cref="IVideo.StopAsync"/>, or to access
-    /// the video file when using the <c>recordVideo</c> context option.
+    /// Video object associated with this page. Can be used to access the video file when
+    /// using the <c>recordVideo</c> context option.
     /// </para>
     /// </summary>
-    IVideo Video { get; }
+    IVideo? Video { get; }
 
     PageViewportSizeResult? ViewportSize { get; }
 

src/Playwright/API/Generated/IPage.cs

@@ -27,14 +27,28 @@
 
 namespace Microsoft.Playwright;
 
-/// <summary>
-/// <para>
-/// Interface for managing page overlays that display persistent visual indicators on
-/// top of the page.
-/// </para>
-/// </summary>
-public partial interface IOverlay
+/// <summary><para>Interface for capturing screencast frames from a page.</para></summary>
+public partial interface IScreencast
 {
+    /// <summary>
+    /// <para>
+    /// Starts the screencast. When <see cref="IScreencast.StartAsync"/> is provided, it
+    /// saves video recording to the specified file. When <see cref="IScreencast.StartAsync"/>
+    /// is provided, delivers JPEG-encoded frames to the callback. Both can be used together.
+    /// </para>
+    /// <para>**Usage**</para>
+    /// </summary>
+    /// <param name="options">Call options</param>
+    Task<IAsyncDisposable> StartAsync(ScreencastStartOptions? options = default);
+
+    /// <summary>
+    /// <para>
+    /// Stops the screencast and video recording if active. If a video was being recorded,
+    /// saves it to the path specified in <see cref="IScreencast.StartAsync"/>.
+    /// </para>
+    /// </summary>
+    Task StopAsync();
+
     /// <summary>
     /// <para>
     /// Adds an overlay with the given HTML content. The overlay is displayed on top of
@@ -43,7 +57,7 @@ public partial interface IOverlay
     /// </summary>
     /// <param name="html">HTML content for the overlay.</param>
     /// <param name="options">Call options</param>
-    Task<IAsyncDisposable> ShowAsync(string html, OverlayShowOptions? options = default);
+    Task<IAsyncDisposable> ShowOverlayAsync(string html, ScreencastShowOverlayOptions? options = default);
 
     /// <summary>
     /// <para>
@@ -54,9 +68,11 @@ public partial interface IOverlay
     /// </summary>
     /// <param name="title">Title text displayed prominently in the overlay.</param>
     /// <param name="options">Call options</param>
-    Task ChapterAsync(string title, OverlayChapterOptions? options = default);
+    Task ShowChapterAsync(string title, ScreencastShowChapterOptions? options = default);
+
+    /// <summary><para>Shows overlays.</para></summary>
+    Task ShowOverlaysAsync();
 
-    /// <summary><para>Sets visibility of all overlays without removing them.</para></summary>
-    /// <param name="visible">Whether overlays should be visible.</param>
-    Task SetVisibleAsync(bool visible);
+    /// <summary><para>Hides overlays without removing them.</para></summary>
+    Task HideOverlaysAsync();
 }

src/Playwright/API/Generated/IOverlay.cs …/Playwright/API/Generated/IScreencast.cssrc/Playwright/API/Generated/IOverlay.cs renamed to src/Playwright/API/Generated/IScreencast.cs src/Playwright/API/Generated/IOverlay.cs renamed to src/Playwright/API/Generated/IScreencast.cs

@@ -22,7 +22,6 @@
  * SOFTWARE.
  */
 
-using System;
 using System.Threading.Tasks;
 
 namespace Microsoft.Playwright;
@@ -33,16 +32,6 @@ namespace Microsoft.Playwright;
 /// a video object associated with it.
 /// </para>
 /// <code>Console.WriteLine(await page.Video.GetPathAsync());</code>
-/// <para>
-/// Alternatively, you can use <see cref="IVideo.StartAsync"/> and <see cref="IVideo.StopAsync"/>
-/// to record video manually. This approach is mutually exclusive with the <c>recordVideo</c>
-/// option.
-/// </para>
-/// <code>
-/// await page.Video.StartAsync(new() { Path = "video.webm" });<br/>
-/// // ... perform actions ...<br/>
-/// await page.Video.StopAsync();
-/// </code>
 /// </summary>
 public partial interface IVideo
 {
@@ -67,22 +56,4 @@ public partial interface IVideo
     /// </summary>
     /// <param name="path">Path where the video should be saved.</param>
     Task SaveAsAsync(string path);
-
-    /// <summary>
-    /// <para>
-    /// Starts video recording. This method is mutually exclusive with the <c>recordVideo</c>
-    /// context option.
-    /// </para>
-    /// <para>**Usage**</para>
-    /// <code>
-    /// await page.Video.StartAsync(new() { Path = "video.webm" });<br/>
-    /// // ... perform actions ...<br/>
-    /// await page.Video.StopAsync();
-    /// </code>
-    /// </summary>
-    /// <param name="options">Call options</param>
-    Task<IAsyncDisposable> StartAsync(VideoStartOptions? options = default);
-
-    /// <summary><para>Stops video recording started with <see cref="IVideo.StartAsync"/>.</para></summary>
-    Task StopAsync();
 }

src/Playwright/API/Generated/IVideo.cs

@@ -26,11 +26,11 @@
 
 namespace Microsoft.Playwright;
 
-public class OverlayChapterOptions
+public class ScreencastShowChapterOptions
 {
-    public OverlayChapterOptions() { }
+    public ScreencastShowChapterOptions() { }
 
-    public OverlayChapterOptions(OverlayChapterOptions clone)
+    public ScreencastShowChapterOptions(ScreencastShowChapterOptions clone)
     {
         if (clone == null)
         {