Merge branch 'trunk' into patch-1

Author: alaahong

.github/workflows/ruby-examples.yml

@@ -41,13 +41,17 @@ jobs:
         if: matrix.os != 'windows'
         run: |
           sudo rm -rf $CHROMEWEBDRIVER $EDGEWEBDRIVER $GECKOWEBDRIVER
-      - name: Start Xvfb
-        if: matrix.os == 'ubuntu'
-        run: Xvfb :99 &
+      - name: Setup Fluxbox and Xvfb
+        if: inputs.os == 'ubuntu'
+        run: |
+          sudo apt-get -y install fluxbox libxss1 libappindicator3-1 libindicator7
+          Xvfb :99 &
+          fluxbox -display :99 &
+          echo "DISPLAY=:99" >> "$GITHUB_ENV"
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 3.0
+          ruby-version: 3.1
           bundler-cache: true
       - name: Install Gems Nightly non-Windows
         if: matrix.release == 'nightly' && matrix.os != 'windows'
@@ -83,11 +87,26 @@ jobs:
         with:
           distribution: 'temurin'
           java-version: 11
-      - name: Run tests
+      - name: Run tests on Windows
+        if: matrix.os == 'windows'
+        uses: nick-invision/[email protected]
+        with:
+          timeout_minutes: 20
+          max_attempts: 2
+          command: |
+            cd examples/ruby
+            bundle exec rspec
+          new_command_on_retry: |
+            cd examples/ruby; $env:DEBUG="true"; bundle exec rspec --only-failures
+      - name: Run tests on ${{ matrix.os }}
+        if: matrix.os != 'windows'
         uses: nick-invision/[email protected]
         with:
           timeout_minutes: 20
-          max_attempts: 3
+          max_attempts: 2
           command: |
             cd examples/ruby
             bundle exec rspec
+          new_command_on_retry: |
+            cd examples/ruby
+            DEBUG=true bundle exec rspec --only-failures      

examples/ruby/spec/hello/hello_selenium_spec.rb renamed to examples/ruby/spec/hello/hello_selenium.rb

@@ -9,6 +9,8 @@
 
   # Disable RSpec exposing methods globally on `Module` and `main`
   config.disable_monkey_patching!
+  Dir.mktmpdir('tmp')
+  config.example_status_persistence_file_path = "tmp/examples.txt"
 
   config.expect_with :rspec do |c|
     c.syntax = :expect
@@ -30,6 +32,7 @@
   def start_session
     options = Selenium::WebDriver::Chrome::Options.new
     options.add_argument('disable-search-engine-choice-screen')
+    options.add_argument('--no-sandbox')
     @driver = Selenium::WebDriver.for(:chrome, options: options)
   end
 

examples/ruby/spec/spec_helper.rb

@@ -42,7 +42,7 @@ a browser. You can find a more comprehensive example in [Writing your first Sele
 {{< gh-codeblock path="/examples/dotnet/HelloSelenium.cs" >}}
 {{< /tab >}}
 {{< tab header="Ruby" >}}
-{{< gh-codeblock path="/examples/ruby/spec/hello/hello_selenium_spec.rb" >}}
+{{< gh-codeblock path="/examples/ruby/spec/hello/hello_selenium.rb" >}}
 {{< /tab >}}
 {{< tab header="JavaScript" >}}
 {{< gh-codeblock path="/examples/javascript/test/hello/helloSelenium.js" >}}

website_and_docs/content/documentation/_index.en.md

@@ -29,7 +29,7 @@ Seleniumの中核は[WebDriver]({{< ref "webdriver.md" >}})であり、様々な
 {{< gh-codeblock path="/examples/dotnet/HelloSelenium.cs" >}}
 {{< /tab >}}
 {{< tab header="Ruby" >}}
-{{< gh-codeblock path="/examples/ruby/spec/hello/hello_selenium_spec.rb" >}}
+{{< gh-codeblock path="/examples/ruby/spec/hello/hello_selenium.rb" >}}
 {{< /tab >}}
 {{< tab header="JavaScript" >}}
 {{< gh-codeblock path="/examples/javascript/test/hello/helloSelenium.js" >}}

website_and_docs/content/documentation/_index.ja.md

@@ -40,7 +40,7 @@ navegadores. Aqui está uma das instruções mais simples que você pode fazer:
 {{< gh-codeblock path="/examples/dotnet/HelloSelenium.cs" >}}
 {{< /tab >}}
 {{< tab header="Ruby" >}}
-{{< gh-codeblock path="/examples/ruby/spec/hello/hello_selenium_spec.rb" >}}
+{{< gh-codeblock path="/examples/ruby/spec/hello/hello_selenium.rb" >}}
 {{< /tab >}}
 {{< tab header="JavaScript" >}}
 {{< gh-codeblock path="/examples/javascript/test/hello/helloSelenium.js" >}}

website_and_docs/content/documentation/_index.pt-br.md

@@ -34,7 +34,7 @@ Selenium 的核心是 [WebDriver]({{< ref "webdriver.md" >}})，这是一个编
 {{< gh-codeblock path="/examples/dotnet/HelloSelenium.cs" >}}
 {{< /tab >}}
 {{< tab header="Ruby" >}}
-{{< gh-codeblock path="/examples/ruby/spec/hello/hello_selenium_spec.rb" >}}
+{{< gh-codeblock path="/examples/ruby/spec/hello/hello_selenium.rb" >}}
 {{< /tab >}}
 {{< tab header="JavaScript" >}}
 {{< gh-codeblock path="/examples/javascript/test/hello/helloSelenium.js" >}}

website_and_docs/content/documentation/_index.zh-cn.md

@@ -135,7 +135,16 @@ options.profile = FirefoxProfile()
 driver = FirefoxDriver(options)
   {{< /tab >}}
 {{< /tabpane >}}
-
+**Note**: Whether you create an empty `FirefoxProfile` or point it to the directory of your own profile, Selenium
+will create a temporary directory to store either the data of the new profile or a copy of your existing one. Every
+time you run your program, a different temporary directory will be created. These directories are not cleaned up
+explicitly by Selenium, they should eventually get removed by the operating system. However, if you want to remove
+the copy manually (e.g. if your profile is large in size), the path of the copy is exposed by the `FirefoxProfile`
+object. Check the language specific implementation to see how to retrieve that location.
+
+If you want to use an existing Firefox profile, you can pass in the path to that profile. Please refer to the official
+[Firefox documentation](https://support.mozilla.org/en-US/kb/profiles-where-firefox-stores-user-data#w_how-do-i-find-my-profile)
+for instructions on how to find the directory of your profile.
 
 ## Service
 

website_and_docs/content/documentation/webdriver/browsers/firefox.en.md

@@ -141,6 +141,16 @@ driver = RemoteWebDriver(options)
 {{< /tabpane >}}
 </div>
 
+**Note**: Whether you create an empty `FirefoxProfile` or point it to the directory of your own profile, Selenium
+will create a temporary directory to store either the data of the new profile or a copy of your existing one. Every
+time you run your program, a different temporary directory will be created. These directories are not cleaned up
+explicitly by Selenium, they should eventually get removed by the operating system. However, if you want to remove
+the copy manually (e.g. if your profile is large in size), the path of the copy is exposed by the `FirefoxProfile`
+object. Check the language specific implementation to see how to retrieve that location.
+
+If you want to use an existing Firefox profile, you can pass in the path to that profile. Please refer to the official
+[Firefox documentation](https://support.mozilla.org/en-US/kb/profiles-where-firefox-stores-user-data#w_how-do-i-find-my-profile)
+for instructions on how to find the directory of your profile.
 
 ## サービス
 

website_and_docs/content/documentation/webdriver/browsers/firefox.ja.md

@@ -140,6 +140,16 @@ driver = RemoteWebDriver(options)
 {{< /tabpane >}}
 </div>
 
+**Note**: Whether you create an empty `FirefoxProfile` or point it to the directory of your own profile, Selenium
+will create a temporary directory to store either the data of the new profile or a copy of your existing one. Every
+time you run your program, a different temporary directory will be created. These directories are not cleaned up
+explicitly by Selenium, they should eventually get removed by the operating system. However, if you want to remove
+the copy manually (e.g. if your profile is large in size), the path of the copy is exposed by the `FirefoxProfile`
+object. Check the language specific implementation to see how to retrieve that location.
+
+If you want to use an existing Firefox profile, you can pass in the path to that profile. Please refer to the official
+[Firefox documentation](https://support.mozilla.org/en-US/kb/profiles-where-firefox-stores-user-data#w_how-do-i-find-my-profile)
+for instructions on how to find the directory of your profile.
 
 ## Service