Merge branch 'trunk' into add_chrome_logs_documentation

aguspe · web-flow · commit b279a987d5ff · 2024-05-17T23:47:04.000+02:00
diff --git a/examples/ruby/Gemfile b/examples/ruby/Gemfile
@@ -7,5 +7,5 @@ gem 'rake', '~> 13.0'
 gem 'rspec', '~> 3.0'
 gem 'rubocop', '~> 1.35'
 gem 'rubocop-rspec', '~> 2.12'
-gem 'selenium-devtools', '= 0.124.0'
+gem 'selenium-devtools', '= 0.125.0'
 gem 'selenium-webdriver', '= 4.20.1'
diff --git a/examples/ruby/Gemfile.lock b/examples/ruby/Gemfile.lock
@@ -14,7 +14,8 @@ GEM
     rainbow (3.1.1)
     rake (13.2.1)
     regexp_parser (2.9.0)
-    rexml (3.2.6)
+    rexml (3.2.8)
+      strscan (>= 3.0.9)
     rspec (3.13.0)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
@@ -54,13 +55,14 @@ GEM
       rubocop (~> 1.40)
     ruby-progressbar (1.13.0)
     rubyzip (2.3.2)
-    selenium-devtools (0.124.0)
+    selenium-devtools (0.125.0)
       selenium-webdriver (~> 4.2)
     selenium-webdriver (4.20.1)
       base64 (~> 0.2)
       rexml (~> 3.2, >= 3.2.5)
       rubyzip (>= 1.2.2, < 3.0)
       websocket (~> 1.0)
+    strscan (3.1.0)
     unicode-display_width (2.5.0)
     websocket (1.2.10)
 
@@ -77,7 +79,7 @@ DEPENDENCIES
   rspec (~> 3.0)
   rubocop (~> 1.35)
   rubocop-rspec (~> 2.12)
-  selenium-devtools (= 0.124.0)
+  selenium-devtools (= 0.125.0)
   selenium-webdriver (= 4.20.1)
 
 BUNDLED WITH
diff --git a/website_and_docs/content/blog/2024/selenium-4-21-released.md b/website_and_docs/content/blog/2024/selenium-4-21-released.md
@@ -0,0 +1,141 @@
+---
+title: "Selenium 4.21 Released!"
+linkTitle: "Selenium 4.21 Released!"
+date: 2024-05-16
+tags: ["selenium"]
+categories: ["releases"]
+author: Diego Molina [@diemol](https://diemol.com)
+images:
+  - "/images/blog/selenium_4.21.png"
+description: >
+  Today we're happy to announce that Selenium 4.21 has been released!
+---
+
+We're very happy to announce the release of Selenium 4.21.0 for 
+Javascript, Ruby, Python, .NET, Java and the Grid!
+Links to everything can be found on our [downloads page][downloads].
+
+### Highlights
+
+  * Chrome DevTools support is now: v123, v124, and v125 (Firefox still uses v85 for all versions)
+  * Selenium has at least [2.4M active users](https://plausible.io/manager.selenium.dev) in the last 30 days. 100k more than last month!
+    * India and United States are the top countries with the most users.
+    * Python is the most used language from the last 5 releases.
+    * The most used operating system is Windows, with at least 1.9M users.
+  * Extensibility points started to be implemented to simplify the integration between Selenium and Appium. Ruby is the first language to implement it. 
+  * Java and JavaScript keep adding more WebDriver [BiDi] features.
+  * In Java, it is possible to set parameters for Selenium Manager via system properties.
+  * Nightly packages are tested daily with the examples from the Selenium [documentation](/documentation). 
+
+
+#### Noteworthy changes per language
+
+  * Java 
+    * Browser containers provisioned in Dynamic Grid will use the hostConfig
+    * Set test name to video file name in Dynamic Grid
+    * [See all changes](https://github.com/SeleniumHQ/selenium/blob/trunk/java/CHANGELOG)
+
+
+  <br>
+  
+  * JavaScript
+    * Ensure `selectVisibleByText` method is same as other languages
+    * [See all changes](https://github.com/SeleniumHQ/selenium/blob/trunk/javascript/node/selenium-webdriver/CHANGES.md)
+  
+  <br>
+  
+  * .NET
+    * Overwrite internal log file if it already exists
+    * [See all changes](https://github.com/SeleniumHQ/selenium/blob/trunk/dotnet/CHANGELOG)
+
+  <br>
+  
+  * Python
+    * Moving ignore_local_proxy_environment_variables to BaseOptions
+    * [See all changes](https://github.com/SeleniumHQ/selenium/blob/trunk/py/CHANGES)
+
+  <br>
+  
+  * Ruby
+    * [See all changes](https://github.com/SeleniumHQ/selenium/blob/trunk/rb/CHANGES)
+
+
+  <br>
+
+  * Rust
+    * [See all changes](https://github.com/SeleniumHQ/selenium/blob/trunk/rust/CHANGELOG.md)
+
+
+
+### Contributors
+
+**Special shout-out to everyone who helped the Selenium Team get this release out!**
+
+#### [Selenium](https://github.com/SeleniumHQ/selenium)
+
+<div class="d-flex justify-content-center">
+  <div class="col-11 p-4 bg-transparent">
+    <div class="row justify-content-center">
+{{< gh-user "https://api.github.com/users/VietND96" >}}
+{{< gh-user "https://api.github.com/users/iampopovich" >}}
+{{< gh-user "https://api.github.com/users/joebandenburg" >}}
+{{< gh-user "https://api.github.com/users/kool79" >}}
+{{< gh-user "https://api.github.com/users/sandeepsuryaprasad" >}}
+    </div>
+  </div>
+</div>
+
+
+#### [Selenium Docs & Website](https://github.com/SeleniumHQ/seleniumhq.github.io)
+
+<div class="row justify-content-center">
+  <div class="col-11 p-4 bg-transparent">
+    <div class="row justify-content-center">
+{{< gh-user "https://api.github.com/users/Arpan3323" >}}
+{{< gh-user "https://api.github.com/users/aguspe" >}}
+{{< gh-user "https://api.github.com/users/chamiz" >}}
+{{< gh-user "https://api.github.com/users/pallavigitwork" >}}
+    </div>
+  </div>
+</div>
+
+#### [Docker Selenium](https://github.com/SeleniumHQ/docker-selenium)
+
+<div class="row justify-content-center">
+  <div class="col-11 p-4 bg-transparent">
+    <div class="row justify-content-center">
+{{< gh-user "https://api.github.com/users/VietND96" >}}
+{{< gh-user "https://api.github.com/users/edhinard" >}}
+    </div>
+  </div>
+</div>
+
+#### [Selenium Team Members][team]
+
+**Thanks as well to all the team members who contributed to this release:**
+
+<div class="row justify-content-center">
+  <div class="col-11 p-4 bg-transparent">
+    <div class="row justify-content-center">
+{{< gh-user "https://api.github.com/users/pujagani" >}}
+{{< gh-user "https://api.github.com/users/diemol" >}}
+{{< gh-user "https://api.github.com/users/bonigarcia" >}}
+{{< gh-user "https://api.github.com/users/harsha509" >}}
+{{< gh-user "https://api.github.com/users/joerg1985" >}}
+{{< gh-user "https://api.github.com/users/nvborisenko" >}}
+{{< gh-user "https://api.github.com/users/p0deje" >}}
+{{< gh-user "https://api.github.com/users/shs96c" >}}
+{{< gh-user "https://api.github.com/users/titusfortner" >}}
+{{< gh-user "https://api.github.com/users/AutomatedTester" >}}
+ </div>
+  </div>
+</div>
+
+Stay tuned for updates by following SeleniumHQ on [X (Formerly Twitter)](https://twitter.com/seleniumhq) or [LinkedIn](https://www.linkedin.com/company/selenium/)!
+
+Happy testing!
+
+[downloads]: /downloads
+[bindings]: /downloads#bindings
+[team]: /project/structure
+[BiDi]: https://github.com/w3c/webdriver-bidi
diff --git a/website_and_docs/content/documentation/grid/advanced_features/customize_node.en.md b/website_and_docs/content/documentation/grid/advanced_features/customize_node.en.md
@@ -95,23 +95,26 @@ public class DecoratedLoggingNode extends Node {
 
   private Node node;
 
-  protected DecoratedLoggingNode(Tracer tracer, NodeId nodeId, URI uri, Secret registrationSecret) {
-	super(tracer, nodeId, uri, registrationSecret);
+  protected DecoratedLoggingNode(Tracer tracer, NodeId nodeId, URI uri, Secret registrationSecret, Duration sessionTimeout) {
+    super(tracer, nodeId, uri, registrationSecret, sessionTimeout);
   }
 
   public static Node create(Config config) {
     LoggingOptions loggingOptions = new LoggingOptions(config);
     BaseServerOptions serverOptions = new BaseServerOptions(config);
     URI uri = serverOptions.getExternalUri();
     SecretOptions secretOptions = new SecretOptions(config);
+    NodeOptions nodeOptions = new NodeOptions(config);
+    Duration sessionTimeout = nodeOptions.getSessionTimeout();
 
     // Refer to the foot notes for additional context on this line.
     Node node = LocalNodeFactory.create(config);
 
     DecoratedLoggingNode wrapper = new DecoratedLoggingNode(loggingOptions.getTracer(),
-				node.getId(),
-				uri,
-				secretOptions.getRegistrationSecret());
+        node.getId(),
+        uri,
+        secretOptions.getRegistrationSecret(),
+        sessionTimeout);
     wrapper.node = node;
     return wrapper;
   }
diff --git a/website_and_docs/content/documentation/grid/advanced_features/customize_node.ja.md b/website_and_docs/content/documentation/grid/advanced_features/customize_node.ja.md
@@ -100,23 +100,26 @@ public class DecoratedLoggingNode extends Node {
 
   private Node node;
 
-  protected DecoratedLoggingNode(Tracer tracer, NodeId nodeId, URI uri, Secret registrationSecret) {
-	super(tracer, nodeId, uri, registrationSecret);
+  protected DecoratedLoggingNode(Tracer tracer, NodeId nodeId, URI uri, Secret registrationSecret, Duration sessionTimeout) {
+    super(tracer, nodeId, uri, registrationSecret, sessionTimeout);
   }
 
   public static Node create(Config config) {
     LoggingOptions loggingOptions = new LoggingOptions(config);
     BaseServerOptions serverOptions = new BaseServerOptions(config);
     URI uri = serverOptions.getExternalUri();
     SecretOptions secretOptions = new SecretOptions(config);
+    NodeOptions nodeOptions = new NodeOptions(config);
+    Duration sessionTimeout = nodeOptions.getSessionTimeout();
 
     // Refer to the foot notes for additional context on this line.
     Node node = LocalNodeFactory.create(config);
 
     DecoratedLoggingNode wrapper = new DecoratedLoggingNode(loggingOptions.getTracer(),
-				node.getId(),
-				uri,
-				secretOptions.getRegistrationSecret());
+        node.getId(),
+        uri,
+        secretOptions.getRegistrationSecret(),
+        sessionTimeout);
     wrapper.node = node;
     return wrapper;
   }
diff --git a/website_and_docs/content/documentation/grid/advanced_features/customize_node.pt-br.md b/website_and_docs/content/documentation/grid/advanced_features/customize_node.pt-br.md
@@ -90,23 +90,26 @@ public class DecoratedLoggingNode extends Node {
 
   private Node node;
 
-  protected DecoratedLoggingNode(Tracer tracer, NodeId nodeId, URI uri, Secret registrationSecret) {
-	super(tracer, nodeId, uri, registrationSecret);
+  protected DecoratedLoggingNode(Tracer tracer, NodeId nodeId, URI uri, Secret registrationSecret, Duration sessionTimeout) {
+    super(tracer, nodeId, uri, registrationSecret, sessionTimeout);
   }
 
   public static Node create(Config config) {
     LoggingOptions loggingOptions = new LoggingOptions(config);
     BaseServerOptions serverOptions = new BaseServerOptions(config);
     URI uri = serverOptions.getExternalUri();
     SecretOptions secretOptions = new SecretOptions(config);
+    NodeOptions nodeOptions = new NodeOptions(config);
+    Duration sessionTimeout = nodeOptions.getSessionTimeout();
 
     // Refer to the foot notes for additional context on this line.
     Node node = LocalNodeFactory.create(config);
 
     DecoratedLoggingNode wrapper = new DecoratedLoggingNode(loggingOptions.getTracer(),
-				node.getId(),
-				uri,
-				secretOptions.getRegistrationSecret());
+        node.getId(),
+        uri,
+        secretOptions.getRegistrationSecret(),
+        sessionTimeout);
     wrapper.node = node;
     return wrapper;
   }
diff --git a/website_and_docs/content/documentation/grid/advanced_features/customize_node.zh-cn.md b/website_and_docs/content/documentation/grid/advanced_features/customize_node.zh-cn.md
@@ -100,23 +100,26 @@ public class DecoratedLoggingNode extends Node {
 
   private Node node;
 
-  protected DecoratedLoggingNode(Tracer tracer, NodeId nodeId, URI uri, Secret registrationSecret) {
-	super(tracer, nodeId, uri, registrationSecret);
+  protected DecoratedLoggingNode(Tracer tracer, NodeId nodeId, URI uri, Secret registrationSecret, Duration sessionTimeout) {
+    super(tracer, nodeId, uri, registrationSecret, sessionTimeout);
   }
 
   public static Node create(Config config) {
     LoggingOptions loggingOptions = new LoggingOptions(config);
     BaseServerOptions serverOptions = new BaseServerOptions(config);
     URI uri = serverOptions.getExternalUri();
     SecretOptions secretOptions = new SecretOptions(config);
+    NodeOptions nodeOptions = new NodeOptions(config);
+    Duration sessionTimeout = nodeOptions.getSessionTimeout();
 
     // Refer to the foot notes for additional context on this line.
     Node node = LocalNodeFactory.create(config);
 
     DecoratedLoggingNode wrapper = new DecoratedLoggingNode(loggingOptions.getTracer(),
-				node.getId(),
-				uri,
-				secretOptions.getRegistrationSecret());
+        node.getId(),
+        uri,
+        secretOptions.getRegistrationSecret(),
+        sessionTimeout);
     wrapper.node = node;
     return wrapper;
   }
diff --git a/website_and_docs/content/documentation/selenium_manager.en.md b/website_and_docs/content/documentation/selenium_manager.en.md
@@ -159,8 +159,8 @@ Let's consider an example. A Selenium binding asks Selenium Manager to resolve c
 
 Selenium Manager includes two additional arguments two handle the cache, namely:
 
-- `--clear-cache`: To remove the cache folder.
-- `--clear-metadata`: To remove the metadata file.
+- `--clear-cache`: To remove the cache folder (equivalent to the environment variable `SE_CLEAR_CACHE=true`).
+- `--clear-metadata`: To remove the metadata file (equivalent to the environment variable `SE_CLEAR_METADATA=true`).
 
 ## Versioning
 Selenium Manager follows the same versioning schema as Selenium. Nevertheless, we use the major version 0 for Selenium Manager releases because it is still in beta. For example, the Selenium Manager binaries shipped with Selenium 4.12.0 corresponds to version 0.4.12.
diff --git a/website_and_docs/content/documentation/selenium_manager.ja.md b/website_and_docs/content/documentation/selenium_manager.ja.md
@@ -159,8 +159,8 @@ Let's consider an example. A Selenium binding asks Selenium Manager to resolve c
 
 Selenium Manager includes two additional arguments two handle the cache, namely:
 
-- `--clear-cache`: To remove the cache folder.
-- `--clear-metadata`: To remove the metadata file.
+- `--clear-cache`: To remove the cache folder (equivalent to the environment variable `SE_CLEAR_CACHE=true`).
+- `--clear-metadata`: To remove the metadata file (equivalent to the environment variable `SE_CLEAR_METADATA=true`).
 
 ## Versioning
 Selenium Manager follows the same versioning schema as Selenium. Nevertheless, we use the major version 0 for Selenium Manager releases because it is still in beta. For example, the Selenium Manager binaries shipped with Selenium 4.12.0 corresponds to version 0.4.12.
diff --git a/website_and_docs/content/documentation/selenium_manager.pt-br.md b/website_and_docs/content/documentation/selenium_manager.pt-br.md
@@ -159,8 +159,8 @@ Let's consider an example. A Selenium binding asks Selenium Manager to resolve c
 
 Selenium Manager includes two additional arguments two handle the cache, namely:
 
-- `--clear-cache`: To remove the cache folder.
-- `--clear-metadata`: To remove the metadata file.
+- `--clear-cache`: To remove the cache folder (equivalent to the environment variable `SE_CLEAR_CACHE=true`).
+- `--clear-metadata`: To remove the metadata file (equivalent to the environment variable `SE_CLEAR_METADATA=true`).
 
 ## Versioning
 Selenium Manager follows the same versioning schema as Selenium. Nevertheless, we use the major version 0 for Selenium Manager releases because it is still in beta. For example, the Selenium Manager binaries shipped with Selenium 4.12.0 corresponds to version 0.4.12.
diff --git a/website_and_docs/content/documentation/selenium_manager.zh-cn.md b/website_and_docs/content/documentation/selenium_manager.zh-cn.md
@@ -159,8 +159,8 @@ Let's consider an example. A Selenium binding asks Selenium Manager to resolve c
 
 Selenium Manager includes two additional arguments two handle the cache, namely:
 
-- `--clear-cache`: To remove the cache folder.
-- `--clear-metadata`: To remove the metadata file.
+- `--clear-cache`: To remove the cache folder (equivalent to the environment variable `SE_CLEAR_CACHE=true`).
+- `--clear-metadata`: To remove the metadata file (equivalent to the environment variable `SE_CLEAR_METADATA=true`).
 
 ## Versioning
 Selenium Manager follows the same versioning schema as Selenium. Nevertheless, we use the major version 0 for Selenium Manager releases because it is still in beta. For example, the Selenium Manager binaries shipped with Selenium 4.12.0 corresponds to version 0.4.12.
diff --git a/website_and_docs/hugo.toml b/website_and_docs/hugo.toml
@@ -220,11 +220,6 @@ enable = false
 	url = "https://www.youtube.com/channel/UCbDlgX_613xNMrDqCe3QNEw"
 	icon = "fab fa-youtube"
         desc = "Check all the conference talks and learn from the community!"
-[[params.links.user]]
-	name = "Selenium in Facebook"
-	url = "https://www.facebook.com/Selenium2.WebDriver"
-	icon = "fab fa-facebook"
-        desc = "Get news and updates in Facebook!"
 # Developer relevant links. These will show up on right side of footer and in the community page if you have one.
 [[params.links.developer]]
 	name = "Software Freedom Conservancy"
diff --git a/website_and_docs/layouts/downloads/list.html b/website_and_docs/layouts/downloads/list.html
@@ -25,7 +25,7 @@
       <div class="card-body">
         <p class="card-text">
           Latest stable version
-          <a href="https://github.com/SeleniumHQ/selenium/releases/download/selenium-4.20.0/selenium-server-4.20.0.jar">4.20.0</a>
+          <a href="https://github.com/SeleniumHQ/selenium/releases/download/selenium-4.21.0/selenium-server-4.21.0.jar">4.21.0</a>
         </p>
         <p class="card-text">
           To use the Selenium Server in a Grid configuration see the
@@ -107,7 +107,7 @@ <h2 class="card-title">
     <div class="card-body">
       <h2 class="card-title">C# NuGet</h2>
       <p class="card-text w-lg-75">
-        Nuget latest release is 4.20.0 Released on April 24, 2024.
+        Nuget latest release is 4.21.0 Released on May 16, 2024.
       </p>
       <ul>
         <li>
diff --git a/website_and_docs/layouts/partials/announcement-banner.html b/website_and_docs/layouts/partials/announcement-banner.html
@@ -6,8 +6,8 @@
     <div class="row g-0 justify-content-center">
       <div class="alert alert-{{ $color }} col-12 fade show mb-0 p-0 -bg-{{ $color }}" role="alert">
         <h4 class="alert-heading text-center m-0">
-          Selenium Conf 2024 Call for Proposals is now open! Submissions close 30 April.
-          <a href="https://2024.seleniumconf.in/submit-a-proposal/?utm_medium=referral&utm_source=selenium.dev&utm_campaign=CFP-launch&utm_content=cfp-page" target='_blank' aria-pressed="true">Learn more & submit</a>
+          Registrations open for Selenium Conf 2024 online - live on 21 June. 
+          <a href="https://2024.seleniumconf.in/?utm_medium=referral&utm_source=selenium.dev&utm_campaign=registration" target='_blank' aria-pressed="true"> Register now!</a>
         </h4>
       </div>
     </div>
diff --git a/website_and_docs/layouts/partials/selenium-clients-and-webdriver-bindings.html b/website_and_docs/layouts/partials/selenium-clients-and-webdriver-bindings.html
diff --git a/website_and_docs/static/images/blog/selenium_4.21.png b/website_and_docs/static/images/blog/selenium_4.21.png
