Merge branch 'trunk' into update-python-browsers-docs

.github/workflows/dotnet-examples.yml

@@ -48,12 +48,12 @@ jobs:
       if: matrix.release == 'stable'
       uses: actions/setup-dotnet@v4
       with:
-        dotnet-version: 6.x
+        dotnet-version: 8.x
     - name: Set up .Net Nightly
       if: matrix.release == 'nightly'
       uses: actions/setup-dotnet@v4
       with:
-        dotnet-version: 6.x
+        dotnet-version: 8.x
         source-url: https://nuget.pkg.github.com/seleniumhq/index.json
       env:
         NUGET_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}

examples/dotnet/SeleniumDocs/BiDi/CDP/NetworkTest.cs

@@ -4,8 +4,8 @@
 using OpenQA.Selenium;
 using OpenQA.Selenium.DevTools;
 using System.Linq;
-using OpenQA.Selenium.DevTools.V127.Network;
-using OpenQA.Selenium.DevTools.V127.Performance;
+using OpenQA.Selenium.DevTools.V128.Network;
+using OpenQA.Selenium.DevTools.V128.Performance;
 
 
 namespace SeleniumDocs.BiDi.CDP
@@ -16,7 +16,7 @@ public class NetworkTest : BaseTest
         [TestInitialize]
         public void Startup()
         {
-            StartDriver("127");
+            StartDriver("128");
         }
 
         [TestMethod]
@@ -109,9 +109,9 @@ public async Task PerformanceMetrics()
             driver.Url = "https://www.selenium.dev/selenium/web/frameset.html";
 
             var session = ((IDevTools)driver).GetDevToolsSession();
-            var domains = session.GetVersionSpecificDomains<OpenQA.Selenium.DevTools.V127.DevToolsSessionDomains>();
+            var domains = session.GetVersionSpecificDomains<OpenQA.Selenium.DevTools.V128.DevToolsSessionDomains>();
 
-            await domains.Performance.Enable(new OpenQA.Selenium.DevTools.V127.Performance.EnableCommandSettings());
+            await domains.Performance.Enable(new OpenQA.Selenium.DevTools.V128.Performance.EnableCommandSettings());
             var metricsResponse =
                 await session.SendCommand<GetMetricsCommandSettings, GetMetricsCommandResponse>(
                     new GetMetricsCommandSettings()
@@ -130,8 +130,8 @@ await session.SendCommand<GetMetricsCommandSettings, GetMetricsCommandResponse>(
         public async Task SetCookie()
         {
             var session = ((IDevTools)driver).GetDevToolsSession();
-            var domains = session.GetVersionSpecificDomains<OpenQA.Selenium.DevTools.V127.DevToolsSessionDomains>();
-            await domains.Network.Enable(new OpenQA.Selenium.DevTools.V127.Network.EnableCommandSettings());
+            var domains = session.GetVersionSpecificDomains<OpenQA.Selenium.DevTools.V128.DevToolsSessionDomains>();
+            await domains.Network.Enable(new OpenQA.Selenium.DevTools.V128.Network.EnableCommandSettings());
 
             var cookieCommandSettings = new SetCookieCommandSettings
             {

examples/dotnet/SeleniumDocs/SeleniumDocs.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
     <PropertyGroup>
-        <TargetFramework>net6.0</TargetFramework>
+        <TargetFramework>net8.0</TargetFramework>
         <GenerateProgramFile>false</GenerateProgramFile>
     </PropertyGroup>
 

examples/java/src/test/java/dev/selenium/elements/LocatorsTest.java

@@ -1,7 +1,25 @@
 package dev.selenium.elements;
-
+import org.openqa.selenium.By;
+import org.openqa.selenium.support.pagefactory.ByChained;
 import dev.selenium.BaseTest;
+import org.openqa.selenium.WebDriver;
+import org.openqa.selenium.WebElement;
+import org.openqa.selenium.chrome.ChromeDriver;
 
 public class LocatorsTest extends BaseTest {
 
+    public String ByChainedTest() {
+        // Create instance of ChromeDriver
+        WebDriver driver = new ChromeDriver();
+        // Navigate to Url
+        driver.get("https://www.selenium.dev/selenium/web/login.html");
+
+        // Find username-field inside of login-form
+        By example = new ByChained(By.id("login-form"), By.id("username-field"));
+        WebElement username_input = driver.findElement(example);
+
+        //return placeholder text
+        String placeholder = username_input.getAttribute("placeholder");
+        return placeholder;
+    }
 }

website_and_docs/content/documentation/_index.ja.md

@@ -10,11 +10,11 @@ Seleniumはブラウザー自動化を可能にし、それを支えるツール
 
 ユーザーとブラウザーのやり取りのエミュレーション、ブラウザーの割当を増強したり縮減する分散型サーバー、そしてすべてのメジャーなブラウザー用に置換可能なコードの実装を可能にする[W3C WebDriver 仕様](//www.w3.org/TR/webdriver/)インフラの提供します。
 
-このプロジェクトは多くの有志貢献者の何千時間に及ぶ個々の時間を費やした事とソースコード[自由に利用可能]({{< ref "/copyright.md#license" >}})を誰にでも利用、楽しめ、そして改良できることによって実現しました。
+このプロジェクトは多くの有志貢献者の何千時間に及ぶ個々の時間を費やした事とソースコード[自由に利用可能]({{< ref "copyright.md#license" >}})を誰にでも利用、楽しめ、そして改良できることによって実現しました。
 
 Seleniumはウェブプラットフォームの自動化のより開かれた議論をするためブラウザーベンダー、エンジニア、愛好家をまとめます。このプロジェクトはコミュニティーを導きと育成のために[年次カンファレンス](//seleniumconf.com/)開催します。
 
-Seleniumの中核は[WebDriver]({{< ref "/webdriver.md" >}})であり、様々なブラウザーを変えてインストラクション集を実行できるインターフェースです。これは作りえる一番基本的な
+Seleniumの中核は[WebDriver]({{< ref "webdriver.md" >}})であり、様々なブラウザーを変えてインストラクション集を実行できるインターフェースです。これは作りえる一番基本的な
 インストラクションの一つです:
 
 

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

@@ -24,7 +24,7 @@ para promover uma discussão aberta sobre a automação da plataforma da web.
 O projeto organiza [uma conferência anual](//seleniumconf.com/)
 para ensinar e nutrir a comunidade.
 
-No núcleo do Selenium está [WebDriver]({{< ref "/webdriver.md" >}}),
+No núcleo do Selenium está [WebDriver]({{< ref "webdriver.md" >}}),
 uma interface para escrever conjuntos de instruções que podem ser executados alternadamente em muitos
 navegadores. Aqui está uma das instruções mais simples que você pode fazer:
 

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

@@ -13,12 +13,12 @@ Selenium 是支持 web 浏览器自动化的一系列工具和库的综合项目
 该 规范 允许您为所有主要 Web 浏览器编写可互换的代码。
 
 这个项目是由志愿者贡献者实现的，他们投入了自己数千小时的时间，
-并使源代码[免费提供]({{< ref "/copyright.md#许可" >}})给任何人使用、享受和改进。
+并使源代码[免费提供]({{< ref "copyright.md#许可" >}})给任何人使用、享受和改进。
 
 Selenium 汇集了浏览器供应商，工程师和爱好者，以进一步围绕 Web 平台自动化进行公开讨论。
 该项目组织了[一次年度会议](//seleniumconf.com/)，以教学和培养社区。
 
-Selenium 的核心是 [WebDriver]({{< ref "/webdriver.md" >}})，这是一个编写指令集的接口，可以在许多浏览器中互换运行。
+Selenium 的核心是 [WebDriver]({{< ref "webdriver.md" >}})，这是一个编写指令集的接口，可以在许多浏览器中互换运行。
 这里有一个最简单的说明：
 
 

website_and_docs/content/documentation/grid/components.en.md

@@ -87,7 +87,7 @@ part of the registration message.
 
 By default, the **Node** auto-registers all browser drivers available on the path of the machine where it runs. 
 It also creates one slot per available CPU for Chromium based browsers and Firefox. For Safari, only one slot is 
-created. Through a specific [configuration]({{< ref "/configuration" >}}), it can run sessions in Docker 
+created. Through a specific [configuration]({{< ref "configuration" >}}), it can run sessions in Docker 
 containers or relay commands.
 
 A **Node** only executes the received commands, it does not evaluate, make judgments, or control anything other

website_and_docs/content/documentation/grid/components.ja.md

@@ -84,7 +84,7 @@ Grid は複数の**ノード**を持つことができます。
 デフォルトでは、**ノード**はマシンのパス上に存在する全てのブラウザドライバーを自動で登録します。
 また FireFox と Chromium ベースブラウザの場合、CPU1 つにつき 1 スロットを作成します。
 Safari の場合は 1 つのスロットのみ作成します。
-[特定の設定によって]({{< ref "/configuration" >}})セッションを Docker コンテナで実行したり、コマンドを中継したりすることも可能です。
+[特定の設定によって]({{< ref "configuration" >}})セッションを Docker コンテナで実行したり、コマンドを中継したりすることも可能です。
 
 **ノード**は受信したコマンドを実行するだけで、コマンドの評価・判断や、フロー制御以外の制御は行いません。
 **ノード**が実行されているマシンは、他のコンポーネントと同じ OS を持つ必要はありません。

website_and_docs/content/documentation/grid/components.pt-br.md

@@ -85,7 +85,7 @@ como parte da mensagem de registo.
 
 Por omissão, o **Node** regista automaticamente todos os navegadores que estejam disponíveis no PATH da máquina onde
 executa. Cria também um slot de execução por cada CPU para os navegadores Chrome e Firefox. Para Safari,
-apenas é criado um slot. Usando uma [configuração]({{< ref "/configuration" >}}) específica, é também
+apenas é criado um slot. Usando uma [configuração]({{< ref "configuration" >}}) específica, é também
 possível executar sessões em containers Docker.
 
 O **Node** apenas executa os comandos que recebe, não avalia, faz julgamentos ou controla mais nada que não seja

website_and_docs/content/documentation/grid/components.zh-cn.md

@@ -67,7 +67,7 @@ Selenium Grid 4 是对以前版本的彻底重写。除了对性能和标准合
 
 **Node**通过**事件总线**向**分发器**注册自己，并将其配置作为注册消息发送。
 
-默认情况下，**Node**会自动注册其所在机器上路径中可用的所有浏览器驱动程序。它还为基于Chromium的浏览器和Firefox创建每个可用CPU一个插槽。对于Safari，只创建一个插槽。通过特定的[配置]({{< ref "/configuration" >}})，它可以在Docker容器中运行会话或转发命令。
+默认情况下，**Node**会自动注册其所在机器上路径中可用的所有浏览器驱动程序。它还为基于Chromium的浏览器和Firefox创建每个可用CPU一个插槽。对于Safari，只创建一个插槽。通过特定的[配置]({{< ref "configuration" >}})，它可以在Docker容器中运行会话或转发命令。
 
 **Node**仅执行接收到的命令，不评估、不做出判断或控制任何除命令和响应流之外的东西。**Node**所在的机器不需要与其他组件具有相同的操作系统。例如，Windows节点可能具有在Edge上提供IE模式作为浏览器选项的能力，而在Linux或Mac上则不可能，网格可以配置多个具有Windows、Mac或Linux的**Node**。
 

website_and_docs/content/documentation/grid/getting_started.en.md

@@ -216,7 +216,7 @@ endpoint or using [GraphQL]({{< ref "advanced_features/graphql_support.md" >}})
 {{% pageinfo color="primary" %}}
 For simplicity, all command examples shown in this page assume that components are running
 locally. More detailed examples and usages can be found in the
-[Configuring Components]({{< ref "/configuration" >}}) section.
+[Configuring Components]({{< ref "configuration" >}}) section.
 {{% /pageinfo %}}
 
 ## Using the Java 11 HTTP Client {{% badge-version version="4.5" %}}
@@ -311,6 +311,6 @@ overview of how a publicly exposed Grid could be misused:
 ## Further reading
 
 * [Components]({{< ref "components.md" >}}): learn how Grid's internal components relate to each other.
-* [Configuration]({{< ref "/configuration" >}}): customize your Grid setup.
+* [Configuration]({{< ref "configuration" >}}): customize your Grid setup.
 * [Architecture]({{< ref "architecture.md" >}}): understand key concepts in Grid.
-* [Advanced Features]({{< ref "/advanced_features" >}}): explore more possibilities through Grid's features.
+* [Advanced Features]({{< ref "advanced_features" >}}): explore more possibilities through Grid's features.

website_and_docs/content/documentation/grid/getting_started.ja.md

@@ -310,6 +310,6 @@ Grid を保護しないと、以下のような問題が発生する可能性が
 ## 参考文献
 
 - [Components]({{< ref "components.md" >}}): 内部のコンポーネントの仕組みを知る
-- [Configuration]({{< ref "/configuration" >}}): Grid の設定をカスタマイズする
+- [Configuration]({{< ref "configuration" >}}): Grid の設定をカスタマイズする
 - [Architecture]({{< ref "architecture.md" >}}): Grid のコンセプトを理解する
-- [Advanced Features]({{< ref "/advanced_features" >}}): Grid のさらなる可能性を探る
+- [Advanced Features]({{< ref "advanced_features" >}}): Grid のさらなる可能性を探る

website_and_docs/content/documentation/grid/getting_started.pt-br.md

@@ -211,7 +211,7 @@ através de [GraphQL]({{< ref "advanced_features/graphql_support.md" >}}).
 
 {{% pageinfo color="primary" %}}
 Para simplificar, todos os exemplos apresentados assumem que os componentes estão a ser executados localmente.
-Exemplos mais detalhados podem ser encontrados na secção [Configurando Componentes]({{< ref "/configuration" >}}).
+Exemplos mais detalhados podem ser encontrados na secção [Configurando Componentes]({{< ref "configuration" >}}).
 {{% /pageinfo %}}
 
 ## Usando o cliente HTTP nativo Java 11 {{% badge-version version="4.5" %}}
@@ -307,6 +307,6 @@ de como uma Grid exposta publicamente pode ser abusada:
 ## Leituras adicionais
 
 * [Componentes]({{< ref "components.md" >}}): compreender como usar os componentes da Grid
-* [Configuração]({{< ref "/configuration" >}}): personalize a sua configuração Grid.
+* [Configuração]({{< ref "configuration" >}}): personalize a sua configuração Grid.
 * [Arquitectura]({{< ref "architecture.md" >}}): entenda conceitos chave da Grid.
-* [Advanced Features]({{< ref "/advanced_features" >}}): explore mais possibilidades da Grid.
+* [Advanced Features]({{< ref "advanced_features" >}}): explore mais possibilidades da Grid.

website_and_docs/content/documentation/grid/getting_started.zh-cn.md

@@ -209,7 +209,7 @@ driver.quit();
 `API` 调用可以通过 [http://localhost:4444/status](http://localhost:4444/status) 端点或使用 [GraphQL]({{< ref "advanced_features/graphql_support.md" >}})
 
 {{% pageinfo color="primary" %}}
-为简单起见，本页中显示的所有命令示例均假定组件正在运行在本地。更详细的示例和用法可以在[配置组件]({{< ref "/configuration" >}}) 部分。
+为简单起见，本页中显示的所有命令示例均假定组件正在运行在本地。更详细的示例和用法可以在[配置组件]({{< ref "configuration" >}}) 部分。
 {{% /pageinfo %}}
 
 ## 使用 Java 11 中的 HTTP Client {{% badge-version version="4.5" %}}
@@ -277,6 +277,6 @@ java -Dwebdriver.http.factory=jdk-http-client -jar selenium-server-<version>.jar
 ## 延伸阅读
 
 * [Components]({{< ref "components.md" >}})：了解 `Grid` 的内部组件如何相互关联。
-* [Configuration]({{< ref "/configuration" >}}): 自定义您的 `Grid` 设置。
+* [Configuration]({{< ref "configuration" >}}): 自定义您的 `Grid` 设置。
 * [Architecture]({{< ref "architecture.md" >}}): 理解 `Grid` 中的关键概念。
-* [Advanced Features]({{< ref "/advanced_features" >}}): 通过Grid的特性探索更多的可能性。
+* [Advanced Features]({{< ref "advanced_features" >}}): 通过Grid的特性探索更多的可能性。

website_and_docs/content/documentation/overview/_index.ja.md

@@ -12,7 +12,7 @@ Seleniumは一つのツールやAPIではありません。たくさんのツー
 ## WebDriver
 
 デスクトップのウェブサイトのテスト自動化をはじめるのなら、WebDriver APIを使いましょう。
-[WebDriver]({{< ref "/webdriver.md" >}}) はブラウザ自動化のAPIを使用します。このAPIは、ブラウザをコントロールしてテストを実行するためにブラウザベンダーによって提供されています。これは現実のユーザーがブラウザを操作するかのように動きます。
+[WebDriver]({{< ref "webdriver.md" >}}) はブラウザ自動化のAPIを使用します。このAPIは、ブラウザをコントロールしてテストを実行するためにブラウザベンダーによって提供されています。これは現実のユーザーがブラウザを操作するかのように動きます。
 WebDriverのAPIはアプリケーションのコードと一緒にコンパイルする必要がありませんから、全く邪魔になりません。
 これによって、あなたは本番環境と同じアプリケーションをテストすることができます。
 
@@ -31,4 +31,4 @@ Selenium Grid を使用すると、さまざまなプラットフォームのさ
 リモート端末によって自動的に実行されます。
 
 WebDriverテストの開発後、複数のブラウザーとオペレーティングシステムの組み合わせでテストを実行する必要が出てくる場合があります。
-ここで [Grid]({{< ref "/grid.md" >}}) が登場します。
+ここで [Grid]({{< ref "grid.md" >}}) が登場します。

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

@@ -13,7 +13,7 @@ mas sim uma composição de várias ferramentas.
 ## WebDriver
 
 Se você está começando com automação de testes de um site de desktop ou site para celular, então
-vai usar as APIs WebDriver. O [WebDriver]({{< ref "/webdriver.md" >}})
+vai usar as APIs WebDriver. O [WebDriver]({{< ref "webdriver.md" >}})
 usa APIs de automação de navegador disponibilizadas por fornecedores de navegador para o controlar e
 executar testes. É como se um usuário real o estivesse operando. Como o
 WebDriver não exige que sua API seja compilada com o código do aplicativo,
@@ -42,4 +42,4 @@ executados pela extremidade remota.
 Após o desenvolvimento dos testes WebDriver, você pode enfrentar
 a necessidade de executar seus testes em vários navegadores e
 combinações de sistemas operacionais.
-É aqui que o [Grid]({{< ref "/grid.md" >}}) entra em cena.
+É aqui que o [Grid]({{< ref "grid.md" >}}) entra em cena.

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

@@ -13,7 +13,7 @@ Selenium 不仅仅是一个工具或 API, 它还包含许多工具.
 ## WebDriver
 
 如果您开始使用桌面网站测试自动化, 那么您将使用 WebDriver APIs. 
-[WebDriver]({{< ref "/webdriver.md" >}}) 使用浏览器供应商提供的浏览器自动化 API 来控制浏览器和运行测试. 
+[WebDriver]({{< ref "webdriver.md" >}}) 使用浏览器供应商提供的浏览器自动化 API 来控制浏览器和运行测试. 
 这就像真正的用户正在操作浏览器一样. 
 由于 WebDriver 不要求使用应用程序代码编译其 API, 因此它本质上不具有侵入性. 
 因此, 您测试的应用程序与实时推送的应用程序相同. 
@@ -35,4 +35,4 @@ Selenium Grid允许您在不同平台的不同机器上运行测试用例.
 
 当开发完WebDriver测试之后, 
 您可能需要在多个浏览器和操作系统的组合上运行测试. 
-这就是 [Grid]({{< ref "/grid.md" >}}) 的用途所在.
+这就是 [Grid]({{< ref "grid.md" >}}) 的用途所在.

website_and_docs/content/documentation/overview/details.ja.md

@@ -41,7 +41,7 @@ Selenium はこれらの違いを "抽象化" し、コードを書いている
 
 Seleniumの必要最小限な設計アプローチは、より大きなアプリケーションのコンポーネントとして含まれる汎用性を提供します。 
 Seleniumの包括的なプロジェクトの下で提供される周辺インフラストラクチャは、
-[ブラウザーのgrid]({{< ref "/grid.md" >}})をまとめるためのツールを提供し、
+[ブラウザーのgrid]({{< ref "grid.md" >}})をまとめるためのツールを提供し、
 さまざまなブラウザーやさまざまなマシンの複数のオペレーティングシステムでテストを実行できるようにします。
 
 サーバールームやデータセンター内の一連のコンピューターがすべて同時にブラウザーを起動して、

website_and_docs/content/documentation/overview/details.pt-br.md

@@ -56,7 +56,7 @@ A abordagem de design minimalista do Selenium lhe dá a
 versatilidade para ser incluído como um componente em aplicações maiores.
 A infraestrutura circundante fornecida sob o Selenium
 dá a você as ferramentas para montar
-sua [Grid de navegadores]({{< ref "/grid.md" >}})
+sua [Grid de navegadores]({{< ref "grid.md" >}})
 para que os testes possam ser executados em diferentes navegadores e sistemas operacionais
 em uma variedade de máquinas.