chore: roll to Playwright v1.49.0 (#513)

Author: canstand

Diff for: Dockerfile.example

@@ -1,11 +1,11 @@
 # Stage 1: Modules caching
-FROM golang:1.21 as modules
+FROM golang:1.22 as modules
 COPY go.mod go.sum /modules/
 WORKDIR /modules
 RUN go mod download
 
 # Stage 2: Build
-FROM golang:1.21 as builder
+FROM golang:1.22 as builder
 COPY --from=modules /go/pkg /go/pkg
 COPY . /workdir
 WORKDIR /workdir
@@ -16,7 +16,7 @@ RUN PWGO_VER=$(grep -oE "playwright-go v\S+" /workdir/go.mod | sed 's/playwright
 RUN GOOS=linux GOARCH=amd64 go build -o /bin/myapp
 
 # Stage 3: Final
-FROM ubuntu:jammy
+FROM ubuntu:noble
 COPY --from=builder /go/bin/playwright /bin/myapp /
 RUN apt-get update && apt-get install -y ca-certificates tzdata \
     # Install dependencies and all browsers (or specify one)

Diff for: README.md

@@ -5,17 +5,17 @@
 [![PkgGoDev](https://pkg.go.dev/badge/github.com/playwright-community/playwright-go)](https://pkg.go.dev/github.com/playwright-community/playwright-go)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](http://opensource.org/licenses/MIT)
 [![Go Report Card](https://goreportcard.com/badge/github.com/playwright-community/playwright-go)](https://goreportcard.com/report/github.com/playwright-community/playwright-go) ![Build Status](https://github.com/playwright-community/playwright-go/workflows/Go/badge.svg)
-[![Join Slack](https://img.shields.io/badge/join-slack-infomational)](https://aka.ms/playwright-slack) [![Coverage Status](https://coveralls.io/repos/github/playwright-community/playwright-go/badge.svg?branch=main)](https://coveralls.io/github/playwright-community/playwright-go?branch=main) <!-- GEN:chromium-version-badge -->[![Chromium version](https://img.shields.io/badge/chromium-130.0.6723.31-blue.svg?logo=google-chrome)](https://www.chromium.org/Home)<!-- GEN:stop --> <!-- GEN:firefox-version-badge -->[![Firefox version](https://img.shields.io/badge/firefox-131.0-blue.svg?logo=mozilla-firefox)](https://www.mozilla.org/en-US/firefox/new/)<!-- GEN:stop --> <!-- GEN:webkit-version-badge -->[![WebKit version](https://img.shields.io/badge/webkit-18.0-blue.svg?logo=safari)](https://webkit.org/)<!-- GEN:stop -->
+[![Join Slack](https://img.shields.io/badge/join-slack-infomational)](https://aka.ms/playwright-slack) [![Coverage Status](https://coveralls.io/repos/github/playwright-community/playwright-go/badge.svg?branch=main)](https://coveralls.io/github/playwright-community/playwright-go?branch=main) <!-- GEN:chromium-version-badge -->[![Chromium version](https://img.shields.io/badge/chromium-131.0.6778.33-blue.svg?logo=google-chrome)](https://www.chromium.org/Home)<!-- GEN:stop --> <!-- GEN:firefox-version-badge -->[![Firefox version](https://img.shields.io/badge/firefox-132.0-blue.svg?logo=mozilla-firefox)](https://www.mozilla.org/en-US/firefox/new/)<!-- GEN:stop --> <!-- GEN:webkit-version-badge -->[![WebKit version](https://img.shields.io/badge/webkit-18.2-blue.svg?logo=safari)](https://webkit.org/)<!-- GEN:stop -->
 
 [API reference](https://playwright.dev/docs/api/class-playwright) | [Example recipes](https://github.com/playwright-community/playwright-go/tree/main/examples)
 
 Playwright is a Go library to automate [Chromium](https://www.chromium.org/Home), [Firefox](https://www.mozilla.org/en-US/firefox/new/) and [WebKit](https://webkit.org/) with a single API. Playwright is built to enable cross-browser web automation that is **ever-green**, **capable**, **reliable** and **fast**.
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->130.0.6723.31<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| WebKit <!-- GEN:webkit-version -->18.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->131.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->131.0.6778.33<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| WebKit <!-- GEN:webkit-version -->18.2<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->132.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 Headless execution is supported for all the browsers on all platforms.
 

Diff for: generated-interfaces.go

@@ -602,11 +602,16 @@ type Clock interface {
 	Resume() error
 
 	// Makes `Date.now` and `new Date()` return fixed fake time at all times, keeps all the timers running.
+	// Use this method for simple scenarios where you only need to test with a predefined time. For more advanced
+	// scenarios, use [Clock.Install] instead. Read docs on [clock emulation] to learn more.
 	//
 	//  time: Time to be set.
+	//
+	// [clock emulation]: https://playwright.dev/docs/clock
 	SetFixedTime(time interface{}) error
 
-	// Sets current system time but does not trigger any timers.
+	// Sets system time, but does not trigger any timers. Use this to test how the web page reacts to a time shift, for
+	// example switching from summer to winter time, or changing time zones.
 	//
 	//  time: Time to be set.
 	SetSystemTime(time interface{}) error
@@ -2179,6 +2184,37 @@ type Locator interface {
 	//  locator: Additional locator to match.
 	And(locator Locator) Locator
 
+	// Captures the aria snapshot of the given element. Read more about [aria snapshots] and
+	// [LocatorAssertions.ToMatchAriaSnapshot] for the corresponding assertion.
+	//
+	// # Details
+	//
+	// This method captures the aria snapshot of the given element. The snapshot is a string that represents the state of
+	// the element and its children. The snapshot can be used to assert the state of the element in the test, or to
+	// compare it to state in the future.
+	// The ARIA snapshot is represented using [YAML] markup language:
+	//  - The keys of the objects are the roles and optional accessible names of the elements.
+	//  - The values are either text content or an array of child elements.
+	//  - Generic static text can be represented with the `text` key.
+	// Below is the HTML markup and the respective ARIA snapshot:
+	// ```html
+	// <ul aria-label="Links">
+	//   <li><a href="/">Home</a></li>
+	//   <li><a href="/about">About</a></li>
+	// <ul>
+	// ```
+	// ```yml
+	//  - list "Links":
+	//   - listitem:
+	//     - link "Home"
+	//   - listitem:
+	//     - link "About"
+	// ```
+	//
+	// [aria snapshots]: https://playwright.dev/docs/aria-snapshots
+	// [YAML]: https://yaml.org/spec/1.2.2/
+	AriaSnapshot(options ...LocatorAriaSnapshotOptions) (string, error)
+
 	// Calls [blur] on the element.
 	//
 	// [blur]: https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/blur
@@ -2949,6 +2985,11 @@ type LocatorAssertions interface {
 	//
 	//  values: Expected options currently selected.
 	ToHaveValues(values []interface{}, options ...LocatorAssertionsToHaveValuesOptions) error
+
+	// Asserts that the target element matches the given [accessibility snapshot].
+	//
+	// [accessibility snapshot]: https://playwright.dev/docs/aria-snapshots
+	ToMatchAriaSnapshot(expected string, options ...LocatorAssertionsToMatchAriaSnapshotOptions) error
 }
 
 // The Mouse class operates in main-frame CSS pixels relative to the top-left corner of the viewport.
@@ -4309,9 +4350,9 @@ type Route interface {
 	//
 	// # Details
 	//
-	// Note that any overrides such as “[object Object]” or “[object Object]” only apply to the request being routed. If
-	// this request results in a redirect, overrides will not be applied to the new redirected request. If you want to
-	// propagate a header through redirects, use the combination of [Route.Fetch] and [Route.Fulfill] instead.
+	// The “[object Object]” option applies to both the routed request and any redirects it initiates. However,
+	// “[object Object]”, “[object Object]”, and “[object Object]” only apply to the original request and are not carried
+	// over to redirected requests.
 	// [Route.Continue] will immediately send the request to the network, other matching handlers won't be invoked. Use
 	// [Route.Fallback] If you want next matching handler in the chain to be invoked.
 	Continue(options ...RouteContinueOptions) error
@@ -4380,6 +4421,16 @@ type Tracing interface {
 	// once, and then create multiple trace chunks with [Tracing.StartChunk] and [Tracing.StopChunk].
 	StartChunk(options ...TracingStartChunkOptions) error
 
+	// **NOTE** Use `test.step` instead when available.
+	// Creates a new group within the trace, assigning any subsequent API calls to this group, until [Tracing.GroupEnd] is
+	// called. Groups can be nested and will be visible in the trace viewer.
+	//
+	//  name: Group name shown in the trace viewer.
+	Group(name string, options ...TracingGroupOptions) error
+
+	// Closes the last group created by [Tracing.Group].
+	GroupEnd() error
+
 	// Stop tracing.
 	Stop(path ...string) error
 

Diff for: generated-structs.go

@@ -363,9 +363,11 @@ type BrowserNewContextOptions struct {
 	// **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
 	// work by replacing `localhost` with `local.playwright`.
 	ClientCertificates []ClientCertificate `json:"clientCertificates"`
-	// Emulates `prefers-colors-scheme` media feature, supported values are `light`, `dark`, `no-preference`. See
-	// [Page.EmulateMedia] for more details. Passing `no-override` resets emulation to system defaults. Defaults to
-	// `light`.
+	// Emulates [prefers-colors-scheme]
+	// media feature, supported values are `light` and `dark`. See [Page.EmulateMedia] for more details. Passing
+	// `no-override` resets emulation to system defaults. Defaults to `light`.
+	//
+	// [prefers-colors-scheme]: https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme
 	ColorScheme *ColorScheme `json:"colorScheme"`
 	// Specify device scale factor (can be thought of as dpr). Defaults to `1`. Learn more about
 	// [emulating devices with device scale factor].
@@ -508,9 +510,11 @@ type BrowserNewPageOptions struct {
 	// **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
 	// work by replacing `localhost` with `local.playwright`.
 	ClientCertificates []ClientCertificate `json:"clientCertificates"`
-	// Emulates `prefers-colors-scheme` media feature, supported values are `light`, `dark`, `no-preference`. See
-	// [Page.EmulateMedia] for more details. Passing `no-override` resets emulation to system defaults. Defaults to
-	// `light`.
+	// Emulates [prefers-colors-scheme]
+	// media feature, supported values are `light` and `dark`. See [Page.EmulateMedia] for more details. Passing
+	// `no-override` resets emulation to system defaults. Defaults to `light`.
+	//
+	// [prefers-colors-scheme]: https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme
 	ColorScheme *ColorScheme `json:"colorScheme"`
 	// Specify device scale factor (can be thought of as dpr). Defaults to `1`. Learn more about
 	// [emulating devices with device scale factor].
@@ -910,9 +914,11 @@ type BrowserTypeLaunchPersistentContextOptions struct {
 	// **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
 	// work by replacing `localhost` with `local.playwright`.
 	ClientCertificates []ClientCertificate `json:"clientCertificates"`
-	// Emulates `prefers-colors-scheme` media feature, supported values are `light`, `dark`, `no-preference`. See
-	// [Page.EmulateMedia] for more details. Passing `no-override` resets emulation to system defaults. Defaults to
-	// `light`.
+	// Emulates [prefers-colors-scheme]
+	// media feature, supported values are `light` and `dark`. See [Page.EmulateMedia] for more details. Passing
+	// `no-override` resets emulation to system defaults. Defaults to `light`.
+	//
+	// [prefers-colors-scheme]: https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme
 	ColorScheme *ColorScheme `json:"colorScheme"`
 	// Specify device scale factor (can be thought of as dpr). Defaults to `1`. Learn more about
 	// [emulating devices with device scale factor].
@@ -2236,6 +2242,12 @@ type KeyboardTypeOptions struct {
 	Delay *float64 `json:"delay"`
 }
 
+type LocatorAriaSnapshotOptions struct {
+	// Maximum time in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can
+	// be changed by using the [BrowserContext.SetDefaultTimeout] or [Page.SetDefaultTimeout] methods.
+	Timeout *float64 `json:"timeout"`
+}
+
 type LocatorBlurOptions struct {
 	// Maximum time in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can
 	// be changed by using the [BrowserContext.SetDefaultTimeout] or [Page.SetDefaultTimeout] methods.
@@ -2990,6 +3002,11 @@ type LocatorAssertionsToHaveValuesOptions struct {
 	Timeout *float64 `json:"timeout"`
 }
 
+type LocatorAssertionsToMatchAriaSnapshotOptions struct {
+	// Time to retry the assertion for in milliseconds. Defaults to `5000`.
+	Timeout *float64 `json:"timeout"`
+}
+
 type MouseClickOptions struct {
 	// Defaults to `left`.
 	Button *MouseButton `json:"button"`
@@ -3197,8 +3214,11 @@ type PageDragAndDropOptions struct {
 }
 
 type PageEmulateMediaOptions struct {
-	// Emulates `prefers-colors-scheme` media feature, supported values are `light`, `dark`, `no-preference`.
-	// Passing `no-override` disables color scheme emulation.
+	// Emulates [prefers-colors-scheme]
+	// media feature, supported values are `light` and `dark`. Passing `no-override` disables color scheme
+	// emulation. `no-preference` is deprecated.
+	//
+	// [prefers-colors-scheme]: https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme
 	ColorScheme  *ColorScheme  `json:"colorScheme"`
 	ForcedColors *ForcedColors `json:"forcedColors"`
 	// Changes the CSS media type of the page. The only allowed values are `screen`, `print` and `no-override`.
@@ -4173,6 +4193,12 @@ type TracingStartChunkOptions struct {
 	Title *string `json:"title"`
 }
 
+type TracingGroupOptions struct {
+	// Specifies a custom location for the group to be shown in the trace viewer. Defaults to the location of the
+	// [Tracing.Group] call.
+	Location *TracingGroupOptionsLocation `json:"location"`
+}
+
 type WebSocketExpectEventOptions struct {
 	// Receives the event data and resolves to truthy value when the waiting should resolve.
 	Predicate interface{} `json:"predicate"`
@@ -4279,3 +4305,9 @@ type Margin struct {
 	// Left margin, accepts values labeled with units. Defaults to `0`.
 	Left *string `json:"left"`
 }
+
+type TracingGroupOptionsLocation struct {
+	File   string `json:"file"`
+	Line   *int   `json:"line"`
+	Column *int   `json:"column"`
+}

Diff for: locator.go

@@ -128,6 +128,19 @@ func (l *locatorImpl) Blur(options ...LocatorBlurOptions) error {
 	return err
 }
 
+func (l *locatorImpl) AriaSnapshot(options ...LocatorAriaSnapshotOptions) (string, error) {
+	var option LocatorAriaSnapshotOptions
+	if len(options) == 1 {
+		option = options[0]
+	}
+	ret, err := l.frame.channel.Send("ariaSnapshot", option,
+		map[string]interface{}{"selector": l.selector})
+	if err != nil {
+		return "", err
+	}
+	return ret.(string), nil
+}
+
 func (l *locatorImpl) BoundingBox(options ...LocatorBoundingBoxOptions) (*Rect, error) {
 	if l.err != nil {
 		return nil, l.err

Diff for: locator_assertions.go

@@ -472,6 +472,22 @@ func (la *locatorAssertionsImpl) ToHaveValues(values []interface{}, options ...L
 	)
 }
 
+func (la *locatorAssertionsImpl) ToMatchAriaSnapshot(expected string, options ...LocatorAssertionsToMatchAriaSnapshotOptions) error {
+	var timeout *float64
+	if len(options) == 1 {
+		timeout = options[0].Timeout
+	}
+	return la.expect(
+		"to.match.aria",
+		frameExpectOptions{
+			ExpectedValue: expected,
+			Timeout:       timeout,
+		},
+		expected,
+		"Locator expected to match Aria snapshot",
+	)
+}
+
 func (la *locatorAssertionsImpl) Not() LocatorAssertions {
 	return newLocatorAssertions(la.actualLocator, true, la.defaultTimeout)
 }