Import of v0.35.0 (#2188)

CHANGES.md

@@ -3,6 +3,50 @@
 
 All notable changes to this program are documented in this file.
 
+## 0.35.0 (2024-08-06, `9f0a0036bea4`)
+
+### Known problems
+
+- _Startup hang with Firefox running in a container (e.g. snap, flatpak):_
+
+  When Firefox is packaged inside a container (like the default Firefox browser
+  shipped with Ubuntu 22.04), it may see a different filesystem to the host.
+  This can affect access to the generated profile directory, which may result
+  in a hang when starting Firefox. Workarounds are listed in the geckodriver
+  [usage documentation].
+
+### Added
+
+- Support for [Permissions] that allow controlling permission prompts
+  within the browser. This enables automated tests to handle scenarios
+  involving permissions like `geolocation`, `notifications`, and more.
+
+- The command line flag `--enable-crash-reporter` has been added, to allow
+  the crash reporter in Firefox to automatically submit crash reports to
+  Mozilla's crash reporting system if a tab or the browser itself crashes.
+
+  Note that this feature is disabled by default and should only be used when a
+  crash situation needs to be investigated. See our documentation for
+  [crash reports] in how to share these with us.
+
+### Changed
+
+- The validation of the `unhandledPromptBehavior` capability has been enhanced
+  to support finer configuration options for the [User Prompt Handler] which
+  are particularly used by [WebDriver BiDi].
+
+### Fixed
+
+- The [Switch To Frame] command now correctly raises an "invalid argument"
+  error when the `id` parameter is missing.
+
+### Removed
+
+- Removed support for session negotiation using the deprecated
+  `desiredCapabilities` and `requiredCapabilities`.
+- Removed support for the `moz:useNonSpecCompliantPointerOrigin` capability,
+  which has not bee supported since Firefox 116.
+
 ## 0.34.0 (2024-01-03, `c44f0d09630a`)
 
 ### Known problems
@@ -343,7 +387,7 @@ All notable changes to this program are documented in this file.
 
 ### Added
 
-- Support for WebDriver clients to opt in to WebDriver BiDi.
+- Support for WebDriver clients to opt in to [WebDriver BiDi].
 
   Introduced the new boolean capability [`webSocketUrl`] that can be used by
   WebDriver clients to opt in to a bidirectional connection. A string capability
@@ -382,7 +426,7 @@ All notable changes to this program are documented in this file.
   - Arguments as specified in [`moz:firefoxOptions`] are now used when starting
     Firefox.
 
-  - Port forwards set for Marionette and the WebSocket server (WebDriver BiDi)
+  - Port forwards set for Marionette and the WebSocket server ([WebDriver BiDi])
     are now correctly removed when geckodriver exits.
 
   - The test root folder is now removed when geckodriver exists.
@@ -1792,7 +1836,7 @@ and greater.
 
 - Fix Get Element Rect command to return floats instead of integers
 
-- Fix passing of web elements to Switch To Frame command
+- Fix passing of web elements to [Switch To Frame] command
 
 - Fix serialisation of script commands
 
@@ -1806,6 +1850,7 @@ and greater.
 - Squash compile warnings
 
 [README]: https://github.com/mozilla/geckodriver/blob/master/README.md
+[crash reports]: <https://firefox-source-docs.mozilla.org/testing/geckodriver/CrashReports.html>
 [usage documentation]: <https://firefox-source-docs.mozilla.org/testing/geckodriver/Usage.html#Running-Firefox-in-an-container-based-package>
 [Browser Toolbox]: https://developer.mozilla.org/en-US/docs/Tools/Browser_Toolbox
 [WebDriver conformance]: https://wpt.fyi/results/webdriver/tests?label=experimental
@@ -1879,9 +1924,15 @@ and greater.
 [Set Timeouts]: https://w3c.github.io/webdriver/webdriver-spec.html#set-timeouts
 [Set Window Rect]: https://w3c.github.io/webdriver/webdriver-spec.html#set-window-rect
 [Status]: https://w3c.github.io/webdriver/webdriver-spec.html#status
+[Switch to Frame]: https://w3c.github.io/webdriver/#dfn-switch-to-frame
 [Take Element Screenshot]: https://w3c.github.io/webdriver/webdriver-spec.html#take-element-screenshot
+[User Prompt Handler]: https://w3c.github.io/webdriver/#user-prompt-handler
 [WebDriver errors]: https://w3c.github.io/webdriver/webdriver-spec.html#handling-errors
 
+[WebDriver BiDi]: https://w3c.github.io/webdriver-bidi/
+
+[Permissions]: https://www.w3.org/TR/permissions/#automation-webdriver-bidi
+
 [Virtual Authenticators]: https://www.w3.org/TR/webauthn-2/#sctn-automation
 [Add Credential]: https://www.w3.org/TR/webauthn-2/#add-credential
 [Add Virtual Authenticator]: https://www.w3.org/TR/webauthn-2/#add-virtual-authenticator