Upgrade to Playwright 1.61.1 by kruppel · Pull Request #1 · kruppel/playwright-ruby-client

kruppel · 2026-06-24T04:07:42Z

Summary

Upgrade playwright-ruby to Playwright 1.61.1.

Key Changes

Frame#expect error handling: Refactored to handle Playwright 1.61+ behavior
- The expect command now resolves on successful match and rejects with FrameExpectErrorDetails on mismatch/timeout
- Changed from parsing result['received'] to catching ::Playwright::Error exceptions
- Returns { 'matches' => !is_not } on success, extracts error details on failure
- Properly handles both isNot flag and error details from server
Error class enhancements: Added support for expect-specific error details
- Added raw_log and details attributes to Error class
- Updated lib/playwright/connection.rb to parse and attach errorDetails from server messages
API coverage documentation: Updated to reflect deprecated/unimplemented features
- Marked local_storage, session_storage, and credentials as unimplemented
- Updated development/api.json with Playwright 1.61.1 schema changes
- Added artifactsDir parameter to BrowserType#connect_over_cdp

kruppel · 2026-06-26T02:19:55Z

 end

- def connect_over_cdp(endpointURL, headers: nil, isLocal: nil, noDefaults: nil, slowMo: nil, timeout: nil, &block)
+ def connect_over_cdp(endpointURL, artifactsDir: nil, headers: nil, isLocal: nil, noDefaults: nil, slowMo: nil, timeout: nil, &block)


https://playwright.dev/docs/api/class-browsertype#browser-type-connect-over-cdp-option-artifacts-dir

kruppel · 2026-06-26T02:33:37Z

- attr_reader :name, :message, :stack
+ attr_reader :name, :message, :stack, :raw_log
+ # Error details for `expect` failures (received value, timedOut, customErrorMessage).
+ attr_accessor :details


The change isn't captured in the release notes, but came from upstream PR #40801 "chore: throw on Frame.expect / Page.expectScreenshot failure".
Here's the difference in the expect protocol across the two versions:
Playwright 1.60.0 — the command returns the result:
exporttypeFrameExpectResult={matches: boolean,received?: {value?: SerializedValue,ariaSnapshot?: string},timedOut?: boolean,errorMessage?: string,log?: string[],};// (no FrameExpectErrorDetails type exists)
Playwright 1.61.1 — the result is gone; failure info moved to a reject-path type:
exporttypeFrameExpectResult=void;// ← resolves with NOTHING on a matchexporttypeFrameExpectErrorDetails={// ← NEW; sent on the error/reject pathreceived?: {value?: SerializedValue,ariaSnapshot?: string},timedOut?: boolean,customErrorMessage?: string,};
In 1.60, the Ruby client read result['matches'] / ['received'] / ['log'] off the return value. In 1.61, since the command returns void, assertions break as the expect call comes back as {"id":7} (no result), and raises undefined method 'key?' for nil at frame.rb:738.
To resolve the failing test:
details carries the new FrameExpectErrorDetails (received / timedOut / customErrorMessage), which now only exists on the error path.
raw_log replaces the old FrameExpectResult.log field (the call-log array), which likewise moved off the result and onto the error's wire log.

Ports Frame#expect to the 1.61 expect protocol: the command now resolves on a successful match and rejects with FrameExpectErrorDetails on mismatch/timeout (upstream microsoft/playwright#40801). Carry errorDetails on Playwright::Error and translate it back into the assertion result hash.

Adds the 1.61 WebStorage API: page.local_storage / page.session_storage expose the current origin's localStorage / sessionStorage via items, get_item, set_item, remove_item and clear, backed by the page channel's webStorage* commands. Registers WebStorage with the API generator and ports the upstream page-localstorage spec.

Adds the 1.61 WebAuthn API: browser_context.credentials exposes a virtual authenticator scoped to the context, with install, create, get and delete backed by the context channel's credentials* commands. Lets tests seed passkeys and answer navigator.credentials ceremonies without real hardware. Registers Credentials with the API generator, maps the class doc examples, and ports the upstream browsercontext-webauthn spec.

Exposes the 1.61 APIResponse fields: security_details returns the TLS certificate details for HTTPS responses (nil for plain HTTP) and server_addr returns the resolved IP address and port, both read from the fetch response initializer. Ports the upstream global-fetch specs covering these methods.

kruppel · 2026-06-24T04:07:42Z

Summary

Upgrade playwright-ruby to Playwright 1.61.1.

Key Changes

Frame#expect error handling: Refactored to handle Playwright 1.61+ behavior
- The expect command now resolves on successful match and rejects with FrameExpectErrorDetails on mismatch/timeout
- Changed from parsing result['received'] to catching ::Playwright::Error exceptions
- Returns { 'matches' => !is_not } on success, extracts error details on failure
- Properly handles both isNot flag and error details from server
Error class enhancements: Added support for expect-specific error details
- Added raw_log and details attributes to Error class
- Updated lib/playwright/connection.rb to parse and attach errorDetails from server messages
API coverage documentation: Updated to reflect deprecated/unimplemented features
- Marked local_storage, session_storage, and credentials as unimplemented
- Updated development/api.json with Playwright 1.61.1 schema changes
- Added artifactsDir parameter to BrowserType#connect_over_cdp

kruppel · 2026-06-26T02:19:55Z

 end

- def connect_over_cdp(endpointURL, headers: nil, isLocal: nil, noDefaults: nil, slowMo: nil, timeout: nil, &block)
+ def connect_over_cdp(endpointURL, artifactsDir: nil, headers: nil, isLocal: nil, noDefaults: nil, slowMo: nil, timeout: nil, &block)


https://playwright.dev/docs/api/class-browsertype#browser-type-connect-over-cdp-option-artifacts-dir

kruppel · 2026-06-26T02:33:37Z

- attr_reader :name, :message, :stack
+ attr_reader :name, :message, :stack, :raw_log
+ # Error details for `expect` failures (received value, timedOut, customErrorMessage).
+ attr_accessor :details


The change isn't captured in the release notes, but came from upstream PR #40801 "chore: throw on Frame.expect / Page.expectScreenshot failure".
Here's the difference in the expect protocol across the two versions:
Playwright 1.60.0 — the command returns the result:
exporttypeFrameExpectResult={matches: boolean,received?: {value?: SerializedValue,ariaSnapshot?: string},timedOut?: boolean,errorMessage?: string,log?: string[],};// (no FrameExpectErrorDetails type exists)
Playwright 1.61.1 — the result is gone; failure info moved to a reject-path type:
exporttypeFrameExpectResult=void;// ← resolves with NOTHING on a matchexporttypeFrameExpectErrorDetails={// ← NEW; sent on the error/reject pathreceived?: {value?: SerializedValue,ariaSnapshot?: string},timedOut?: boolean,customErrorMessage?: string,};
In 1.60, the Ruby client read result['matches'] / ['received'] / ['log'] off the return value. In 1.61, since the command returns void, assertions break as the expect call comes back as {"id":7} (no result), and raises undefined method 'key?' for nil at frame.rb:738.
To resolve the failing test:
details carries the new FrameExpectErrorDetails (received / timedOut / customErrorMessage), which now only exists on the error path.
raw_log replaces the old FrameExpectResult.log field (the call-log array), which likewise moved off the result and onto the error's wire log.

Ports Frame#expect to the 1.61 expect protocol: the command now resolves on a successful match and rejects with FrameExpectErrorDetails on mismatch/timeout (upstream microsoft/playwright#40801). Carry errorDetails on Playwright::Error and translate it back into the assertion result hash.

Adds the 1.61 WebStorage API: page.local_storage / page.session_storage expose the current origin's localStorage / sessionStorage via items, get_item, set_item, remove_item and clear, backed by the page channel's webStorage* commands. Registers WebStorage with the API generator and ports the upstream page-localstorage spec.

Adds the 1.61 WebAuthn API: browser_context.credentials exposes a virtual authenticator scoped to the context, with install, create, get and delete backed by the context channel's credentials* commands. Lets tests seed passkeys and answer navigator.credentials ceremonies without real hardware. Registers Credentials with the API generator, maps the class doc examples, and ports the upstream browsercontext-webauthn spec.

Exposes the 1.61 APIResponse fields: security_details returns the TLS certificate details for HTTPS responses (nil for plain HTTP) and server_addr returns the resolved IP address and port, both read from the fetch response initializer. Ports the upstream global-fetch specs covering these methods.

kruppel · 2026-06-24T04:07:42Z

Summary

Upgrade playwright-ruby to Playwright 1.61.1.

Key Changes

Frame#expect error handling: Refactored to handle Playwright 1.61+ behavior
- The expect command now resolves on successful match and rejects with FrameExpectErrorDetails on mismatch/timeout
- Changed from parsing result['received'] to catching ::Playwright::Error exceptions
- Returns { 'matches' => !is_not } on success, extracts error details on failure
- Properly handles both isNot flag and error details from server
Error class enhancements: Added support for expect-specific error details
- Added raw_log and details attributes to Error class
- Updated lib/playwright/connection.rb to parse and attach errorDetails from server messages
API coverage documentation: Updated to reflect deprecated/unimplemented features
- Marked local_storage, session_storage, and credentials as unimplemented
- Updated development/api.json with Playwright 1.61.1 schema changes
- Added artifactsDir parameter to BrowserType#connect_over_cdp

kruppel · 2026-06-26T02:19:55Z

 end

- def connect_over_cdp(endpointURL, headers: nil, isLocal: nil, noDefaults: nil, slowMo: nil, timeout: nil, &block)
+ def connect_over_cdp(endpointURL, artifactsDir: nil, headers: nil, isLocal: nil, noDefaults: nil, slowMo: nil, timeout: nil, &block)


https://playwright.dev/docs/api/class-browsertype#browser-type-connect-over-cdp-option-artifacts-dir

kruppel · 2026-06-26T02:33:37Z

- attr_reader :name, :message, :stack
+ attr_reader :name, :message, :stack, :raw_log
+ # Error details for `expect` failures (received value, timedOut, customErrorMessage).
+ attr_accessor :details


The change isn't captured in the release notes, but came from upstream PR #40801 "chore: throw on Frame.expect / Page.expectScreenshot failure".
Here's the difference in the expect protocol across the two versions:
Playwright 1.60.0 — the command returns the result:
exporttypeFrameExpectResult={matches: boolean,received?: {value?: SerializedValue,ariaSnapshot?: string},timedOut?: boolean,errorMessage?: string,log?: string[],};// (no FrameExpectErrorDetails type exists)
Playwright 1.61.1 — the result is gone; failure info moved to a reject-path type:
exporttypeFrameExpectResult=void;// ← resolves with NOTHING on a matchexporttypeFrameExpectErrorDetails={// ← NEW; sent on the error/reject pathreceived?: {value?: SerializedValue,ariaSnapshot?: string},timedOut?: boolean,customErrorMessage?: string,};
In 1.60, the Ruby client read result['matches'] / ['received'] / ['log'] off the return value. In 1.61, since the command returns void, assertions break as the expect call comes back as {"id":7} (no result), and raises undefined method 'key?' for nil at frame.rb:738.
To resolve the failing test:
details carries the new FrameExpectErrorDetails (received / timedOut / customErrorMessage), which now only exists on the error path.
raw_log replaces the old FrameExpectResult.log field (the call-log array), which likewise moved off the result and onto the error's wire log.

Ports Frame#expect to the 1.61 expect protocol: the command now resolves on a successful match and rejects with FrameExpectErrorDetails on mismatch/timeout (upstream microsoft/playwright#40801). Carry errorDetails on Playwright::Error and translate it back into the assertion result hash.

Adds the 1.61 WebStorage API: page.local_storage / page.session_storage expose the current origin's localStorage / sessionStorage via items, get_item, set_item, remove_item and clear, backed by the page channel's webStorage* commands. Registers WebStorage with the API generator and ports the upstream page-localstorage spec.

Adds the 1.61 WebAuthn API: browser_context.credentials exposes a virtual authenticator scoped to the context, with install, create, get and delete backed by the context channel's credentials* commands. Lets tests seed passkeys and answer navigator.credentials ceremonies without real hardware. Registers Credentials with the API generator, maps the class doc examples, and ports the upstream browsercontext-webauthn spec.

Exposes the 1.61 APIResponse fields: security_details returns the TLS certificate details for HTTPS responses (nil for plain HTTP) and server_addr returns the resolved IP address and port, both read from the fetch response initializer. Ports the upstream global-fetch specs covering these methods.

kruppel · 2026-06-24T04:07:42Z

Summary

Upgrade playwright-ruby to Playwright 1.61.1.

Key Changes

Frame#expect error handling: Refactored to handle Playwright 1.61+ behavior
- The expect command now resolves on successful match and rejects with FrameExpectErrorDetails on mismatch/timeout
- Changed from parsing result['received'] to catching ::Playwright::Error exceptions
- Returns { 'matches' => !is_not } on success, extracts error details on failure
- Properly handles both isNot flag and error details from server
Error class enhancements: Added support for expect-specific error details
- Added raw_log and details attributes to Error class
- Updated lib/playwright/connection.rb to parse and attach errorDetails from server messages
API coverage documentation: Updated to reflect deprecated/unimplemented features
- Marked local_storage, session_storage, and credentials as unimplemented
- Updated development/api.json with Playwright 1.61.1 schema changes
- Added artifactsDir parameter to BrowserType#connect_over_cdp

kruppel · 2026-06-26T02:19:55Z

 end

- def connect_over_cdp(endpointURL, headers: nil, isLocal: nil, noDefaults: nil, slowMo: nil, timeout: nil, &block)
+ def connect_over_cdp(endpointURL, artifactsDir: nil, headers: nil, isLocal: nil, noDefaults: nil, slowMo: nil, timeout: nil, &block)


https://playwright.dev/docs/api/class-browsertype#browser-type-connect-over-cdp-option-artifacts-dir

kruppel · 2026-06-26T02:33:37Z

- attr_reader :name, :message, :stack
+ attr_reader :name, :message, :stack, :raw_log
+ # Error details for `expect` failures (received value, timedOut, customErrorMessage).
+ attr_accessor :details


The change isn't captured in the release notes, but came from upstream PR #40801 "chore: throw on Frame.expect / Page.expectScreenshot failure".
Here's the difference in the expect protocol across the two versions:
Playwright 1.60.0 — the command returns the result:
exporttypeFrameExpectResult={matches: boolean,received?: {value?: SerializedValue,ariaSnapshot?: string},timedOut?: boolean,errorMessage?: string,log?: string[],};// (no FrameExpectErrorDetails type exists)
Playwright 1.61.1 — the result is gone; failure info moved to a reject-path type:
exporttypeFrameExpectResult=void;// ← resolves with NOTHING on a matchexporttypeFrameExpectErrorDetails={// ← NEW; sent on the error/reject pathreceived?: {value?: SerializedValue,ariaSnapshot?: string},timedOut?: boolean,customErrorMessage?: string,};
In 1.60, the Ruby client read result['matches'] / ['received'] / ['log'] off the return value. In 1.61, since the command returns void, assertions break as the expect call comes back as {"id":7} (no result), and raises undefined method 'key?' for nil at frame.rb:738.
To resolve the failing test:
details carries the new FrameExpectErrorDetails (received / timedOut / customErrorMessage), which now only exists on the error path.
raw_log replaces the old FrameExpectResult.log field (the call-log array), which likewise moved off the result and onto the error's wire log.

Ports Frame#expect to the 1.61 expect protocol: the command now resolves on a successful match and rejects with FrameExpectErrorDetails on mismatch/timeout (upstream microsoft/playwright#40801). Carry errorDetails on Playwright::Error and translate it back into the assertion result hash.

Adds the 1.61 WebStorage API: page.local_storage / page.session_storage expose the current origin's localStorage / sessionStorage via items, get_item, set_item, remove_item and clear, backed by the page channel's webStorage* commands. Registers WebStorage with the API generator and ports the upstream page-localstorage spec.

Adds the 1.61 WebAuthn API: browser_context.credentials exposes a virtual authenticator scoped to the context, with install, create, get and delete backed by the context channel's credentials* commands. Lets tests seed passkeys and answer navigator.credentials ceremonies without real hardware. Registers Credentials with the API generator, maps the class doc examples, and ports the upstream browsercontext-webauthn spec.

Exposes the 1.61 APIResponse fields: security_details returns the TLS certificate details for HTTPS responses (nil for plain HTTP) and server_addr returns the resolved IP address and port, both read from the fetch response initializer. Ports the upstream global-fetch specs covering these methods.

kruppel · 2026-06-24T04:07:42Z

Summary

Upgrade playwright-ruby to Playwright 1.61.1.

Key Changes

Frame#expect error handling: Refactored to handle Playwright 1.61+ behavior
- The expect command now resolves on successful match and rejects with FrameExpectErrorDetails on mismatch/timeout
- Changed from parsing result['received'] to catching ::Playwright::Error exceptions
- Returns { 'matches' => !is_not } on success, extracts error details on failure
- Properly handles both isNot flag and error details from server
Error class enhancements: Added support for expect-specific error details
- Added raw_log and details attributes to Error class
- Updated lib/playwright/connection.rb to parse and attach errorDetails from server messages
API coverage documentation: Updated to reflect deprecated/unimplemented features
- Marked local_storage, session_storage, and credentials as unimplemented
- Updated development/api.json with Playwright 1.61.1 schema changes
- Added artifactsDir parameter to BrowserType#connect_over_cdp

kruppel · 2026-06-26T02:19:55Z

 end

- def connect_over_cdp(endpointURL, headers: nil, isLocal: nil, noDefaults: nil, slowMo: nil, timeout: nil, &block)
+ def connect_over_cdp(endpointURL, artifactsDir: nil, headers: nil, isLocal: nil, noDefaults: nil, slowMo: nil, timeout: nil, &block)


https://playwright.dev/docs/api/class-browsertype#browser-type-connect-over-cdp-option-artifacts-dir

kruppel · 2026-06-26T02:33:37Z

- attr_reader :name, :message, :stack
+ attr_reader :name, :message, :stack, :raw_log
+ # Error details for `expect` failures (received value, timedOut, customErrorMessage).
+ attr_accessor :details


The change isn't captured in the release notes, but came from upstream PR #40801 "chore: throw on Frame.expect / Page.expectScreenshot failure".
Here's the difference in the expect protocol across the two versions:
Playwright 1.60.0 — the command returns the result:
exporttypeFrameExpectResult={matches: boolean,received?: {value?: SerializedValue,ariaSnapshot?: string},timedOut?: boolean,errorMessage?: string,log?: string[],};// (no FrameExpectErrorDetails type exists)
Playwright 1.61.1 — the result is gone; failure info moved to a reject-path type:
exporttypeFrameExpectResult=void;// ← resolves with NOTHING on a matchexporttypeFrameExpectErrorDetails={// ← NEW; sent on the error/reject pathreceived?: {value?: SerializedValue,ariaSnapshot?: string},timedOut?: boolean,customErrorMessage?: string,};
In 1.60, the Ruby client read result['matches'] / ['received'] / ['log'] off the return value. In 1.61, since the command returns void, assertions break as the expect call comes back as {"id":7} (no result), and raises undefined method 'key?' for nil at frame.rb:738.
To resolve the failing test:
details carries the new FrameExpectErrorDetails (received / timedOut / customErrorMessage), which now only exists on the error path.
raw_log replaces the old FrameExpectResult.log field (the call-log array), which likewise moved off the result and onto the error's wire log.

Ports Frame#expect to the 1.61 expect protocol: the command now resolves on a successful match and rejects with FrameExpectErrorDetails on mismatch/timeout (upstream microsoft/playwright#40801). Carry errorDetails on Playwright::Error and translate it back into the assertion result hash.

Adds the 1.61 WebStorage API: page.local_storage / page.session_storage expose the current origin's localStorage / sessionStorage via items, get_item, set_item, remove_item and clear, backed by the page channel's webStorage* commands. Registers WebStorage with the API generator and ports the upstream page-localstorage spec.

Adds the 1.61 WebAuthn API: browser_context.credentials exposes a virtual authenticator scoped to the context, with install, create, get and delete backed by the context channel's credentials* commands. Lets tests seed passkeys and answer navigator.credentials ceremonies without real hardware. Registers Credentials with the API generator, maps the class doc examples, and ports the upstream browsercontext-webauthn spec.

Exposes the 1.61 APIResponse fields: security_details returns the TLS certificate details for HTTPS responses (nil for plain HTTP) and server_addr returns the resolved IP address and port, both read from the fetch response initializer. Ports the upstream global-fetch specs covering these methods.

kruppel · 2026-06-24T04:07:42Z

Summary

Upgrade playwright-ruby to Playwright 1.61.1.

Key Changes

Frame#expect error handling: Refactored to handle Playwright 1.61+ behavior
- The expect command now resolves on successful match and rejects with FrameExpectErrorDetails on mismatch/timeout
- Changed from parsing result['received'] to catching ::Playwright::Error exceptions
- Returns { 'matches' => !is_not } on success, extracts error details on failure
- Properly handles both isNot flag and error details from server
Error class enhancements: Added support for expect-specific error details
- Added raw_log and details attributes to Error class
- Updated lib/playwright/connection.rb to parse and attach errorDetails from server messages
API coverage documentation: Updated to reflect deprecated/unimplemented features
- Marked local_storage, session_storage, and credentials as unimplemented
- Updated development/api.json with Playwright 1.61.1 schema changes
- Added artifactsDir parameter to BrowserType#connect_over_cdp

kruppel · 2026-06-26T02:19:55Z

 end

- def connect_over_cdp(endpointURL, headers: nil, isLocal: nil, noDefaults: nil, slowMo: nil, timeout: nil, &block)
+ def connect_over_cdp(endpointURL, artifactsDir: nil, headers: nil, isLocal: nil, noDefaults: nil, slowMo: nil, timeout: nil, &block)


https://playwright.dev/docs/api/class-browsertype#browser-type-connect-over-cdp-option-artifacts-dir

kruppel · 2026-06-26T02:33:37Z

- attr_reader :name, :message, :stack
+ attr_reader :name, :message, :stack, :raw_log
+ # Error details for `expect` failures (received value, timedOut, customErrorMessage).
+ attr_accessor :details


The change isn't captured in the release notes, but came from upstream PR #40801 "chore: throw on Frame.expect / Page.expectScreenshot failure".
Here's the difference in the expect protocol across the two versions:
Playwright 1.60.0 — the command returns the result:
exporttypeFrameExpectResult={matches: boolean,received?: {value?: SerializedValue,ariaSnapshot?: string},timedOut?: boolean,errorMessage?: string,log?: string[],};// (no FrameExpectErrorDetails type exists)
Playwright 1.61.1 — the result is gone; failure info moved to a reject-path type:
exporttypeFrameExpectResult=void;// ← resolves with NOTHING on a matchexporttypeFrameExpectErrorDetails={// ← NEW; sent on the error/reject pathreceived?: {value?: SerializedValue,ariaSnapshot?: string},timedOut?: boolean,customErrorMessage?: string,};
In 1.60, the Ruby client read result['matches'] / ['received'] / ['log'] off the return value. In 1.61, since the command returns void, assertions break as the expect call comes back as {"id":7} (no result), and raises undefined method 'key?' for nil at frame.rb:738.
To resolve the failing test:
details carries the new FrameExpectErrorDetails (received / timedOut / customErrorMessage), which now only exists on the error path.
raw_log replaces the old FrameExpectResult.log field (the call-log array), which likewise moved off the result and onto the error's wire log.

Ports Frame#expect to the 1.61 expect protocol: the command now resolves on a successful match and rejects with FrameExpectErrorDetails on mismatch/timeout (upstream microsoft/playwright#40801). Carry errorDetails on Playwright::Error and translate it back into the assertion result hash.

Adds the 1.61 WebStorage API: page.local_storage / page.session_storage expose the current origin's localStorage / sessionStorage via items, get_item, set_item, remove_item and clear, backed by the page channel's webStorage* commands. Registers WebStorage with the API generator and ports the upstream page-localstorage spec.

Adds the 1.61 WebAuthn API: browser_context.credentials exposes a virtual authenticator scoped to the context, with install, create, get and delete backed by the context channel's credentials* commands. Lets tests seed passkeys and answer navigator.credentials ceremonies without real hardware. Registers Credentials with the API generator, maps the class doc examples, and ports the upstream browsercontext-webauthn spec.

Exposes the 1.61 APIResponse fields: security_details returns the TLS certificate details for HTTPS responses (nil for plain HTTP) and server_addr returns the resolved IP address and port, both read from the fetch response initializer. Ports the upstream global-fetch specs covering these methods.

kruppel · 2026-06-24T04:07:42Z

Summary

Upgrade playwright-ruby to Playwright 1.61.1.

Key Changes

Frame#expect error handling: Refactored to handle Playwright 1.61+ behavior
- The expect command now resolves on successful match and rejects with FrameExpectErrorDetails on mismatch/timeout
- Changed from parsing result['received'] to catching ::Playwright::Error exceptions
- Returns { 'matches' => !is_not } on success, extracts error details on failure
- Properly handles both isNot flag and error details from server
Error class enhancements: Added support for expect-specific error details
- Added raw_log and details attributes to Error class
- Updated lib/playwright/connection.rb to parse and attach errorDetails from server messages
API coverage documentation: Updated to reflect deprecated/unimplemented features
- Marked local_storage, session_storage, and credentials as unimplemented
- Updated development/api.json with Playwright 1.61.1 schema changes
- Added artifactsDir parameter to BrowserType#connect_over_cdp

kruppel · 2026-06-26T02:19:55Z

 end

- def connect_over_cdp(endpointURL, headers: nil, isLocal: nil, noDefaults: nil, slowMo: nil, timeout: nil, &block)
+ def connect_over_cdp(endpointURL, artifactsDir: nil, headers: nil, isLocal: nil, noDefaults: nil, slowMo: nil, timeout: nil, &block)


https://playwright.dev/docs/api/class-browsertype#browser-type-connect-over-cdp-option-artifacts-dir

kruppel · 2026-06-26T02:33:37Z

- attr_reader :name, :message, :stack
+ attr_reader :name, :message, :stack, :raw_log
+ # Error details for `expect` failures (received value, timedOut, customErrorMessage).
+ attr_accessor :details


The change isn't captured in the release notes, but came from upstream PR #40801 "chore: throw on Frame.expect / Page.expectScreenshot failure".
Here's the difference in the expect protocol across the two versions:
Playwright 1.60.0 — the command returns the result:
exporttypeFrameExpectResult={matches: boolean,received?: {value?: SerializedValue,ariaSnapshot?: string},timedOut?: boolean,errorMessage?: string,log?: string[],};// (no FrameExpectErrorDetails type exists)
Playwright 1.61.1 — the result is gone; failure info moved to a reject-path type:
exporttypeFrameExpectResult=void;// ← resolves with NOTHING on a matchexporttypeFrameExpectErrorDetails={// ← NEW; sent on the error/reject pathreceived?: {value?: SerializedValue,ariaSnapshot?: string},timedOut?: boolean,customErrorMessage?: string,};
In 1.60, the Ruby client read result['matches'] / ['received'] / ['log'] off the return value. In 1.61, since the command returns void, assertions break as the expect call comes back as {"id":7} (no result), and raises undefined method 'key?' for nil at frame.rb:738.
To resolve the failing test:
details carries the new FrameExpectErrorDetails (received / timedOut / customErrorMessage), which now only exists on the error path.
raw_log replaces the old FrameExpectResult.log field (the call-log array), which likewise moved off the result and onto the error's wire log.

Ports Frame#expect to the 1.61 expect protocol: the command now resolves on a successful match and rejects with FrameExpectErrorDetails on mismatch/timeout (upstream microsoft/playwright#40801). Carry errorDetails on Playwright::Error and translate it back into the assertion result hash.

Adds the 1.61 WebStorage API: page.local_storage / page.session_storage expose the current origin's localStorage / sessionStorage via items, get_item, set_item, remove_item and clear, backed by the page channel's webStorage* commands. Registers WebStorage with the API generator and ports the upstream page-localstorage spec.

Adds the 1.61 WebAuthn API: browser_context.credentials exposes a virtual authenticator scoped to the context, with install, create, get and delete backed by the context channel's credentials* commands. Lets tests seed passkeys and answer navigator.credentials ceremonies without real hardware. Registers Credentials with the API generator, maps the class doc examples, and ports the upstream browsercontext-webauthn spec.

Exposes the 1.61 APIResponse fields: security_details returns the TLS certificate details for HTTPS responses (nil for plain HTTP) and server_addr returns the resolved IP address and port, both read from the fetch response initializer. Ports the upstream global-fetch specs covering these methods.

kruppel · 2026-06-24T04:07:42Z

Summary

Upgrade playwright-ruby to Playwright 1.61.1.

Key Changes

Frame#expect error handling: Refactored to handle Playwright 1.61+ behavior
- The expect command now resolves on successful match and rejects with FrameExpectErrorDetails on mismatch/timeout
- Changed from parsing result['received'] to catching ::Playwright::Error exceptions
- Returns { 'matches' => !is_not } on success, extracts error details on failure
- Properly handles both isNot flag and error details from server
Error class enhancements: Added support for expect-specific error details
- Added raw_log and details attributes to Error class
- Updated lib/playwright/connection.rb to parse and attach errorDetails from server messages
API coverage documentation: Updated to reflect deprecated/unimplemented features
- Marked local_storage, session_storage, and credentials as unimplemented
- Updated development/api.json with Playwright 1.61.1 schema changes
- Added artifactsDir parameter to BrowserType#connect_over_cdp

kruppel · 2026-06-26T02:19:55Z

 end

- def connect_over_cdp(endpointURL, headers: nil, isLocal: nil, noDefaults: nil, slowMo: nil, timeout: nil, &block)
+ def connect_over_cdp(endpointURL, artifactsDir: nil, headers: nil, isLocal: nil, noDefaults: nil, slowMo: nil, timeout: nil, &block)


https://playwright.dev/docs/api/class-browsertype#browser-type-connect-over-cdp-option-artifacts-dir

kruppel · 2026-06-26T02:33:37Z

- attr_reader :name, :message, :stack
+ attr_reader :name, :message, :stack, :raw_log
+ # Error details for `expect` failures (received value, timedOut, customErrorMessage).
+ attr_accessor :details


The change isn't captured in the release notes, but came from upstream PR #40801 "chore: throw on Frame.expect / Page.expectScreenshot failure".
Here's the difference in the expect protocol across the two versions:
Playwright 1.60.0 — the command returns the result:
exporttypeFrameExpectResult={matches: boolean,received?: {value?: SerializedValue,ariaSnapshot?: string},timedOut?: boolean,errorMessage?: string,log?: string[],};// (no FrameExpectErrorDetails type exists)
Playwright 1.61.1 — the result is gone; failure info moved to a reject-path type:
exporttypeFrameExpectResult=void;// ← resolves with NOTHING on a matchexporttypeFrameExpectErrorDetails={// ← NEW; sent on the error/reject pathreceived?: {value?: SerializedValue,ariaSnapshot?: string},timedOut?: boolean,customErrorMessage?: string,};
In 1.60, the Ruby client read result['matches'] / ['received'] / ['log'] off the return value. In 1.61, since the command returns void, assertions break as the expect call comes back as {"id":7} (no result), and raises undefined method 'key?' for nil at frame.rb:738.
To resolve the failing test:
details carries the new FrameExpectErrorDetails (received / timedOut / customErrorMessage), which now only exists on the error path.
raw_log replaces the old FrameExpectResult.log field (the call-log array), which likewise moved off the result and onto the error's wire log.

Ports Frame#expect to the 1.61 expect protocol: the command now resolves on a successful match and rejects with FrameExpectErrorDetails on mismatch/timeout (upstream microsoft/playwright#40801). Carry errorDetails on Playwright::Error and translate it back into the assertion result hash.

Adds the 1.61 WebStorage API: page.local_storage / page.session_storage expose the current origin's localStorage / sessionStorage via items, get_item, set_item, remove_item and clear, backed by the page channel's webStorage* commands. Registers WebStorage with the API generator and ports the upstream page-localstorage spec.

Adds the 1.61 WebAuthn API: browser_context.credentials exposes a virtual authenticator scoped to the context, with install, create, get and delete backed by the context channel's credentials* commands. Lets tests seed passkeys and answer navigator.credentials ceremonies without real hardware. Registers Credentials with the API generator, maps the class doc examples, and ports the upstream browsercontext-webauthn spec.

Exposes the 1.61 APIResponse fields: security_details returns the TLS certificate details for HTTPS responses (nil for plain HTTP) and server_addr returns the resolved IP address and port, both read from the fetch response initializer. Ports the upstream global-fetch specs covering these methods.

kruppel force-pushed the kurt/playwright-1.61.1 branch 3 times, most recently from 3f5d099 to 8862204Compare June 26, 2026 02:13

kruppel commented Jun 26, 2026
View reviewed changes

kruppel force-pushed the kurt/playwright-1.61.1 branch from 8862204 to cfc42abCompare June 26, 2026 02:40

kruppel added 3 commits June 25, 2026 19:55

kruppel force-pushed the kurt/playwright-1.61.1 branch from c7b94dc to f6583cbCompare June 26, 2026 02:57

kruppel marked this pull request as ready for review June 26, 2026 02:59

kruppel closed this Jun 26, 2026

kruppel force-pushed the kurt/playwright-1.61.1 branch 3 times, most recently from 3f5d099 to 8862204Compare June 26, 2026 02:13

kruppel commented Jun 26, 2026
View reviewed changes

kruppel force-pushed the kurt/playwright-1.61.1 branch from 8862204 to cfc42abCompare June 26, 2026 02:40

kruppel added 3 commits June 25, 2026 19:55

kruppel force-pushed the kurt/playwright-1.61.1 branch from c7b94dc to f6583cbCompare June 26, 2026 02:57

kruppel marked this pull request as ready for review June 26, 2026 02:59

kruppel closed this Jun 26, 2026

kruppel force-pushed the kurt/playwright-1.61.1 branch 3 times, most recently from 3f5d099 to 8862204Compare June 26, 2026 02:13

kruppel commented Jun 26, 2026
View reviewed changes

kruppel force-pushed the kurt/playwright-1.61.1 branch from 8862204 to cfc42abCompare June 26, 2026 02:40

kruppel added 3 commits June 25, 2026 19:55

kruppel force-pushed the kurt/playwright-1.61.1 branch from c7b94dc to f6583cbCompare June 26, 2026 02:57

kruppel marked this pull request as ready for review June 26, 2026 02:59

kruppel closed this Jun 26, 2026

kruppel force-pushed the kurt/playwright-1.61.1 branch 3 times, most recently from 3f5d099 to 8862204Compare June 26, 2026 02:13

kruppel commented Jun 26, 2026
View reviewed changes

kruppel force-pushed the kurt/playwright-1.61.1 branch from 8862204 to cfc42abCompare June 26, 2026 02:40

kruppel added 3 commits June 25, 2026 19:55

kruppel force-pushed the kurt/playwright-1.61.1 branch from c7b94dc to f6583cbCompare June 26, 2026 02:57

kruppel marked this pull request as ready for review June 26, 2026 02:59

kruppel closed this Jun 26, 2026

kruppel force-pushed the kurt/playwright-1.61.1 branch 3 times, most recently from 3f5d099 to 8862204Compare June 26, 2026 02:13

kruppel commented Jun 26, 2026
View reviewed changes

kruppel force-pushed the kurt/playwright-1.61.1 branch from 8862204 to cfc42abCompare June 26, 2026 02:40

kruppel added 3 commits June 25, 2026 19:55

kruppel force-pushed the kurt/playwright-1.61.1 branch from c7b94dc to f6583cbCompare June 26, 2026 02:57

kruppel marked this pull request as ready for review June 26, 2026 02:59

kruppel closed this Jun 26, 2026

kruppel force-pushed the kurt/playwright-1.61.1 branch 3 times, most recently from 3f5d099 to 8862204Compare June 26, 2026 02:13

kruppel commented Jun 26, 2026
View reviewed changes

kruppel force-pushed the kurt/playwright-1.61.1 branch from 8862204 to cfc42abCompare June 26, 2026 02:40

kruppel added 3 commits June 25, 2026 19:55

kruppel force-pushed the kurt/playwright-1.61.1 branch from c7b94dc to f6583cbCompare June 26, 2026 02:57

kruppel marked this pull request as ready for review June 26, 2026 02:59

kruppel closed this Jun 26, 2026

kruppel force-pushed the kurt/playwright-1.61.1 branch 3 times, most recently from 3f5d099 to 8862204Compare June 26, 2026 02:13

kruppel commented Jun 26, 2026
View reviewed changes

kruppel force-pushed the kurt/playwright-1.61.1 branch from 8862204 to cfc42abCompare June 26, 2026 02:40

kruppel added 3 commits June 25, 2026 19:55

kruppel force-pushed the kurt/playwright-1.61.1 branch from c7b94dc to f6583cbCompare June 26, 2026 02:57

kruppel marked this pull request as ready for review June 26, 2026 02:59

kruppel closed this Jun 26, 2026

kruppel force-pushed the kurt/playwright-1.61.1 branch 3 times, most recently from 3f5d099 to 8862204Compare June 26, 2026 02:13

kruppel commented Jun 26, 2026
View reviewed changes

kruppel force-pushed the kurt/playwright-1.61.1 branch from 8862204 to cfc42abCompare June 26, 2026 02:40

kruppel added 3 commits June 25, 2026 19:55

kruppel force-pushed the kurt/playwright-1.61.1 branch from c7b94dc to f6583cbCompare June 26, 2026 02:57

kruppel marked this pull request as ready for review June 26, 2026 02:59

kruppel closed this Jun 26, 2026

Conversation

kruppel commented Jun 24, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Key Changes

Uh oh!

kruppelJun 26, 2026

Choose a reason for hiding this comment

Uh oh!

kruppelJun 26, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

kruppel commented Jun 24, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Key Changes

Uh oh!

kruppelJun 26, 2026

Choose a reason for hiding this comment

Uh oh!

kruppelJun 26, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

kruppel commented Jun 24, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Key Changes

Uh oh!

kruppelJun 26, 2026

Choose a reason for hiding this comment

Uh oh!

kruppelJun 26, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

kruppel commented Jun 24, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Key Changes

Uh oh!

kruppelJun 26, 2026

Choose a reason for hiding this comment

Uh oh!

kruppelJun 26, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

kruppel commented Jun 24, 2026•
edited
Loading

kruppelJun 26, 2026•
edited
Loading

kruppel commented Jun 24, 2026•
edited
Loading

kruppelJun 26, 2026•
edited
Loading

kruppel commented Jun 24, 2026•
edited
Loading

kruppelJun 26, 2026•
edited
Loading

kruppel commented Jun 24, 2026•
edited
Loading

kruppelJun 26, 2026•
edited
Loading

kruppel commented Jun 24, 2026•
edited
Loading

kruppelJun 26, 2026•
edited
Loading

kruppel commented Jun 24, 2026•
edited
Loading

kruppelJun 26, 2026•
edited
Loading