diff --git a/website_and_docs/content/documentation/webdriver/drivers/_index.en.md b/website_and_docs/content/documentation/webdriver/drivers/_index.en.md index 6acdfc5bc22..ed2d2c949b8 100644 --- a/website_and_docs/content/documentation/webdriver/drivers/_index.en.md +++ b/website_and_docs/content/documentation/webdriver/drivers/_index.en.md @@ -1,11 +1,47 @@ --- -title: "Configuring driver parameters" +title: "Driver Sessions" linkTitle: "Drivers" -weight: 12 +weight: 3 --- -We learned how to [install drivers]({{< ref "../getting_started/install_drivers.md" >}}) in the Getting Started section. +Starting and stopping a session is for opening and closing a browser. -Selenium provides access to Service classes which are used to determine how the server is started +## Creating Sessions +Creating a new session corresponds with the W3C command for [New session](https://w3c.github.io/webdriver/#new-session) +The session is created automatically by initializing a new Driver class object. + +Each language allows a session to be created with arguments from one of these classes (or equivalent): + +* [Options]({{< ref "options.md" >}}) to describe the kind of session you want; default values are used for local, but this is required for remote +* Some form of [CommandExecutor]({{< ref "executors.md" >}}) (the implementation varies between languages) +* [Listeners]({{< ref "listeners.md" >}}) + +### Local Driver + +The primary unique argument for starting a local driver includes information about starting the required driver service +on the local machine. + +* [Service]({{< ref "service.md" >}}) object applies only to local drivers and provides information about the browser driver + +{{< alert-code >}} +Show Starting Local driver with multiple arguments. +{{< /alert-code >}} + +### Remote Driver + +The primary unique argument for starting a remote driver includes information about where to execute the code. +Read the details in the [Remote Driver Section]() + + +## Quitting Sessions + +Quitting a session corresponds to W3C command for [Deleting a Session](https://w3c.github.io/webdriver/#delete-session). + +Important note: the `quit` method is different from the `close` method, +and it is recommended to always use `quit` to end the session + +{{< alert-code >}} +Show quitting a session. +{{< /alert-code >}} diff --git a/website_and_docs/content/documentation/webdriver/drivers/_index.ja.md b/website_and_docs/content/documentation/webdriver/drivers/_index.ja.md index f5742511300..ed2d2c949b8 100644 --- a/website_and_docs/content/documentation/webdriver/drivers/_index.ja.md +++ b/website_and_docs/content/documentation/webdriver/drivers/_index.ja.md @@ -1,12 +1,47 @@ --- -title: "Configuring driver parameters" +title: "Driver Sessions" linkTitle: "Drivers" -weight: 12 -needsTranslation: true +weight: 3 --- -We learned how to [install drivers]({{< ref "../getting_started/install_drivers.md" >}}) in the Getting Started section. +Starting and stopping a session is for opening and closing a browser. -Selenium provides access to Service classes which are used to determine how the server is started +## Creating Sessions +Creating a new session corresponds with the W3C command for [New session](https://w3c.github.io/webdriver/#new-session) +The session is created automatically by initializing a new Driver class object. + +Each language allows a session to be created with arguments from one of these classes (or equivalent): + +* [Options]({{< ref "options.md" >}}) to describe the kind of session you want; default values are used for local, but this is required for remote +* Some form of [CommandExecutor]({{< ref "executors.md" >}}) (the implementation varies between languages) +* [Listeners]({{< ref "listeners.md" >}}) + +### Local Driver + +The primary unique argument for starting a local driver includes information about starting the required driver service +on the local machine. + +* [Service]({{< ref "service.md" >}}) object applies only to local drivers and provides information about the browser driver + +{{< alert-code >}} +Show Starting Local driver with multiple arguments. +{{< /alert-code >}} + +### Remote Driver + +The primary unique argument for starting a remote driver includes information about where to execute the code. +Read the details in the [Remote Driver Section]() + + +## Quitting Sessions + +Quitting a session corresponds to W3C command for [Deleting a Session](https://w3c.github.io/webdriver/#delete-session). + +Important note: the `quit` method is different from the `close` method, +and it is recommended to always use `quit` to end the session + +{{< alert-code >}} +Show quitting a session. +{{< /alert-code >}} diff --git a/website_and_docs/content/documentation/webdriver/drivers/_index.pt-br.md b/website_and_docs/content/documentation/webdriver/drivers/_index.pt-br.md index 107057178ae..ed2d2c949b8 100644 --- a/website_and_docs/content/documentation/webdriver/drivers/_index.pt-br.md +++ b/website_and_docs/content/documentation/webdriver/drivers/_index.pt-br.md @@ -1,10 +1,47 @@ --- -title: "Configurando o driver" +title: "Driver Sessions" linkTitle: "Drivers" -weight: 12 -needsTranslation: true +weight: 3 --- -Nós aprendemos como [instalar drivers]({{< ref "../getting_started/install_drivers.md" >}}) na sessão de Introdução. +Starting and stopping a session is for opening and closing a browser. -Selenium concede o acesso para classes de serviço que são usadas para determinar como o servidor será iniciado. +## Creating Sessions + +Creating a new session corresponds with the W3C command for [New session](https://w3c.github.io/webdriver/#new-session) + +The session is created automatically by initializing a new Driver class object. + +Each language allows a session to be created with arguments from one of these classes (or equivalent): + +* [Options]({{< ref "options.md" >}}) to describe the kind of session you want; default values are used for local, but this is required for remote +* Some form of [CommandExecutor]({{< ref "executors.md" >}}) (the implementation varies between languages) +* [Listeners]({{< ref "listeners.md" >}}) + +### Local Driver + +The primary unique argument for starting a local driver includes information about starting the required driver service +on the local machine. + +* [Service]({{< ref "service.md" >}}) object applies only to local drivers and provides information about the browser driver + +{{< alert-code >}} +Show Starting Local driver with multiple arguments. +{{< /alert-code >}} + +### Remote Driver + +The primary unique argument for starting a remote driver includes information about where to execute the code. +Read the details in the [Remote Driver Section]() + + +## Quitting Sessions + +Quitting a session corresponds to W3C command for [Deleting a Session](https://w3c.github.io/webdriver/#delete-session). + +Important note: the `quit` method is different from the `close` method, +and it is recommended to always use `quit` to end the session + +{{< alert-code >}} +Show quitting a session. +{{< /alert-code >}} diff --git a/website_and_docs/content/documentation/webdriver/drivers/_index.zh-cn.md b/website_and_docs/content/documentation/webdriver/drivers/_index.zh-cn.md index 50589b5bb05..ed2d2c949b8 100644 --- a/website_and_docs/content/documentation/webdriver/drivers/_index.zh-cn.md +++ b/website_and_docs/content/documentation/webdriver/drivers/_index.zh-cn.md @@ -1,12 +1,47 @@ --- -title: "配置驱动参数" -linkTitle: "驱动" -weight: 12 +title: "Driver Sessions" +linkTitle: "Drivers" +weight: 3 --- -我们在入门部分学习了如何[安装驱动]({{< ref "../getting_started/install_drivers.md" >}}) . +Starting and stopping a session is for opening and closing a browser. -Selenium提供对服务类的访问, -这些服务类用于确定服务器的启动方式 +## Creating Sessions +Creating a new session corresponds with the W3C command for [New session](https://w3c.github.io/webdriver/#new-session) +The session is created automatically by initializing a new Driver class object. + +Each language allows a session to be created with arguments from one of these classes (or equivalent): + +* [Options]({{< ref "options.md" >}}) to describe the kind of session you want; default values are used for local, but this is required for remote +* Some form of [CommandExecutor]({{< ref "executors.md" >}}) (the implementation varies between languages) +* [Listeners]({{< ref "listeners.md" >}}) + +### Local Driver + +The primary unique argument for starting a local driver includes information about starting the required driver service +on the local machine. + +* [Service]({{< ref "service.md" >}}) object applies only to local drivers and provides information about the browser driver + +{{< alert-code >}} +Show Starting Local driver with multiple arguments. +{{< /alert-code >}} + +### Remote Driver + +The primary unique argument for starting a remote driver includes information about where to execute the code. +Read the details in the [Remote Driver Section]() + + +## Quitting Sessions + +Quitting a session corresponds to W3C command for [Deleting a Session](https://w3c.github.io/webdriver/#delete-session). + +Important note: the `quit` method is different from the `close` method, +and it is recommended to always use `quit` to end the session + +{{< alert-code >}} +Show quitting a session. +{{< /alert-code >}} diff --git a/website_and_docs/content/documentation/webdriver/drivers/executors.en.md b/website_and_docs/content/documentation/webdriver/drivers/executors.en.md new file mode 100644 index 00000000000..3657d1690b9 --- /dev/null +++ b/website_and_docs/content/documentation/webdriver/drivers/executors.en.md @@ -0,0 +1,9 @@ +--- +title: "Command executors" +linkTitle: "Executors" +weight: 3 +--- + +These allow you to set various parameters for the HTTP library + +{{< alert-code />}} diff --git a/website_and_docs/content/documentation/webdriver/drivers/executors.ja.md b/website_and_docs/content/documentation/webdriver/drivers/executors.ja.md new file mode 100644 index 00000000000..3657d1690b9 --- /dev/null +++ b/website_and_docs/content/documentation/webdriver/drivers/executors.ja.md @@ -0,0 +1,9 @@ +--- +title: "Command executors" +linkTitle: "Executors" +weight: 3 +--- + +These allow you to set various parameters for the HTTP library + +{{< alert-code />}} diff --git a/website_and_docs/content/documentation/webdriver/drivers/executors.pt-br.md b/website_and_docs/content/documentation/webdriver/drivers/executors.pt-br.md new file mode 100644 index 00000000000..3657d1690b9 --- /dev/null +++ b/website_and_docs/content/documentation/webdriver/drivers/executors.pt-br.md @@ -0,0 +1,9 @@ +--- +title: "Command executors" +linkTitle: "Executors" +weight: 3 +--- + +These allow you to set various parameters for the HTTP library + +{{< alert-code />}} diff --git a/website_and_docs/content/documentation/webdriver/drivers/executors.zh-cn.md b/website_and_docs/content/documentation/webdriver/drivers/executors.zh-cn.md new file mode 100644 index 00000000000..3657d1690b9 --- /dev/null +++ b/website_and_docs/content/documentation/webdriver/drivers/executors.zh-cn.md @@ -0,0 +1,9 @@ +--- +title: "Command executors" +linkTitle: "Executors" +weight: 3 +--- + +These allow you to set various parameters for the HTTP library + +{{< alert-code />}} diff --git a/website_and_docs/content/documentation/webdriver/drivers/listeners.en.md b/website_and_docs/content/documentation/webdriver/drivers/listeners.en.md new file mode 100644 index 00000000000..af51fbabb14 --- /dev/null +++ b/website_and_docs/content/documentation/webdriver/drivers/listeners.en.md @@ -0,0 +1,9 @@ +--- +title: "Command Listeners" +linkTitle: "Listeners" +weight: 3 +--- + +These allow you to execute custom actions in every time specific Selenium commands are sent + +{{< alert-code />}} diff --git a/website_and_docs/content/documentation/webdriver/drivers/listeners.ja.md b/website_and_docs/content/documentation/webdriver/drivers/listeners.ja.md new file mode 100644 index 00000000000..af51fbabb14 --- /dev/null +++ b/website_and_docs/content/documentation/webdriver/drivers/listeners.ja.md @@ -0,0 +1,9 @@ +--- +title: "Command Listeners" +linkTitle: "Listeners" +weight: 3 +--- + +These allow you to execute custom actions in every time specific Selenium commands are sent + +{{< alert-code />}} diff --git a/website_and_docs/content/documentation/webdriver/drivers/listeners.pt-br.md b/website_and_docs/content/documentation/webdriver/drivers/listeners.pt-br.md new file mode 100644 index 00000000000..af51fbabb14 --- /dev/null +++ b/website_and_docs/content/documentation/webdriver/drivers/listeners.pt-br.md @@ -0,0 +1,9 @@ +--- +title: "Command Listeners" +linkTitle: "Listeners" +weight: 3 +--- + +These allow you to execute custom actions in every time specific Selenium commands are sent + +{{< alert-code />}} diff --git a/website_and_docs/content/documentation/webdriver/drivers/listeners.zh-cn.md b/website_and_docs/content/documentation/webdriver/drivers/listeners.zh-cn.md new file mode 100644 index 00000000000..af51fbabb14 --- /dev/null +++ b/website_and_docs/content/documentation/webdriver/drivers/listeners.zh-cn.md @@ -0,0 +1,9 @@ +--- +title: "Command Listeners" +linkTitle: "Listeners" +weight: 3 +--- + +These allow you to execute custom actions in every time specific Selenium commands are sent + +{{< alert-code />}} diff --git a/website_and_docs/content/documentation/webdriver/capabilities/shared.en.md b/website_and_docs/content/documentation/webdriver/drivers/options.en.md similarity index 96% rename from website_and_docs/content/documentation/webdriver/capabilities/shared.en.md rename to website_and_docs/content/documentation/webdriver/drivers/options.en.md index 948dc9fdca2..5c0bcbc1a46 100644 --- a/website_and_docs/content/documentation/webdriver/capabilities/shared.en.md +++ b/website_and_docs/content/documentation/webdriver/drivers/options.en.md @@ -1,10 +1,11 @@ --- -title: "Shared capabilities" -linkTitle: "Shared" +title: "Browser Options" +linkTitle: "Options" weight: 2 description: >- These capabilities are shared by all browsers. aliases: [ +"/documentation/en/capabilitis/shared/", "/documentation/en/driver_idiosyncrasies/shared_capabilities/", "/documentation/webdriver/capabilities/shared_capabilities/", "/documentation/en/webdriver/http_proxies/", @@ -16,14 +17,13 @@ aliases: [ ] --- -In order to create a new session by Selenium WebDriver, -the local end should provide the basic capabilities to the remote end. -The remote end uses the same set of capabilities to -create a session and describes the current session features. +In Selenium 3, capabilities were defined in a session by using Desired Capabilities classes. +As of Selenium 4, you must use the browser options classes. +For remote driver sessions, a browser options instance is required as it determines which browser will be used. -WebDriver provides capabilities that each remote -end will/should support the implementation. -The following capabilities are supported by WebDriver: +These options are described in the w3c specification for [Capabilities](https://w3c.github.io/webdriver/#capabilities). + +Each browser has [custom options]() that may be defined in addition to the ones defined in the specification. ## browserName diff --git a/website_and_docs/content/documentation/webdriver/capabilities/shared.ja.md b/website_and_docs/content/documentation/webdriver/drivers/options.ja.md similarity index 96% rename from website_and_docs/content/documentation/webdriver/capabilities/shared.ja.md rename to website_and_docs/content/documentation/webdriver/drivers/options.ja.md index 6ff1d034d51..2adaeaf007a 100644 --- a/website_and_docs/content/documentation/webdriver/capabilities/shared.ja.md +++ b/website_and_docs/content/documentation/webdriver/drivers/options.ja.md @@ -1,10 +1,11 @@ --- -title: "共通のCapability" -linkTitle: "共通のCapability" +title: "Browser Options" +linkTitle: "Options" weight: 2 description: >- これらのCapabilityはすべてのブラウザで共通です。 aliases: [ +"/documentation/ja/capabilitis/shared/", "/documentation/ja/driver_idiosyncrasies/shared_capabilities/", "/ja/documentation/webdriver/capabilities/shared_capabilities/", "/documentation/ja/webdriver/http_proxies/", @@ -25,11 +26,13 @@ aliases: [

{{% /pageinfo %}} -Selenium WebDriverで新しいセッションを作成するには、ローカルエンドがリモートエンドに基本的なCapabilities（ブラウザの設定情報）を提供する必要があります。 -リモートエンドは、一連の同じCapabilityを使用してセッションを作成し、現在のセッション機能を描きます。 +In Selenium 3, capabilities were defined in a session by using Desired Capabilities classes. +As of Selenium 4, you must use the browser options classes. +For remote driver sessions, a browser options instance is required as it determines which browser will be used. -WebDriverは、各リモートエンドがCapabilityをサポートする/すべきCapabilityを提供します。 -WebDriverがサポートするCapabilityは次のとおりです。 +These options are described in the w3c specification for [Capabilities](https://w3c.github.io/webdriver/#capabilities). + +Each browser has [custom options]() that may be defined in addition to the ones defined in the specification. ## browserName diff --git a/website_and_docs/content/documentation/webdriver/capabilities/shared.pt-br.md b/website_and_docs/content/documentation/webdriver/drivers/options.pt-br.md similarity index 96% rename from website_and_docs/content/documentation/webdriver/capabilities/shared.pt-br.md rename to website_and_docs/content/documentation/webdriver/drivers/options.pt-br.md index ff5a69888fe..a5f82351958 100644 --- a/website_and_docs/content/documentation/webdriver/capabilities/shared.pt-br.md +++ b/website_and_docs/content/documentation/webdriver/drivers/options.pt-br.md @@ -1,11 +1,12 @@ --- -title: "Recursos compartilhados" -linkTitle: "Recursos compartilhados" +title: "Browser Options" +linkTitle: "Options" weight: 2 needsTranslation: true description: >- These capabilities are shared by all browsers. aliases: [ +"/documentation/pt-br/capabilitis/shared/", "/documentation/pt-br/driver_idiosyncrasies/shared_capabilities/", "/pt-br/documentation/webdriver/capabilities/shared_capabilities/", "/documentation/pt-br/webdriver/http_proxies/", @@ -26,14 +27,13 @@ aliases: [

{{% /pageinfo %}} -Para criar uma nova sessão por Selenium WebDriver, -a extremidade local deve fornecer os recursos básicos para a extremidade remota. -A extremidade remota usa o mesmo conjunto de recursos para -cria uma sessão e descreve os recursos da sessão atual. +In Selenium 3, capabilities were defined in a session by using Desired Capabilities classes. +As of Selenium 4, you must use the browser options classes. +For remote driver sessions, a browser options instance is required as it determines which browser will be used. -WebDriver fornece recursos que cada controle extremidade -remota irá/deverá apoiar a implementação. -A seguir estão os recursos que o WebDriver suporta: +These options are described in the w3c specification for [Capabilities](https://w3c.github.io/webdriver/#capabilities). + +Each browser has [custom options]() that may be defined in addition to the ones defined in the specification. ## browserName diff --git a/website_and_docs/content/documentation/webdriver/capabilities/shared.zh-cn.md b/website_and_docs/content/documentation/webdriver/drivers/options.zh-cn.md similarity index 96% rename from website_and_docs/content/documentation/webdriver/capabilities/shared.zh-cn.md rename to website_and_docs/content/documentation/webdriver/drivers/options.zh-cn.md index a55322d9e87..64446c4cfad 100644 --- a/website_and_docs/content/documentation/webdriver/capabilities/shared.zh-cn.md +++ b/website_and_docs/content/documentation/webdriver/drivers/options.zh-cn.md @@ -1,10 +1,11 @@ --- -title: "共享的功能" -linkTitle: "共享的功能" +title: "Browser Options" +linkTitle: "Options" weight: 2 description: >- 这些capabilities用于所有浏览器. aliases: [ +"/documentation/zh-cn/capabilitis/shared/", "/documentation/zh-cn/driver_idiosyncrasies/shared_capabilities/", "/zh-cn/documentation/webdriver/capabilities/shared_capabilities/", "/documentation/zh-cn/webdriver/http_proxies/", @@ -15,14 +16,14 @@ aliases: [ "/zh-cn/documentation/webdriver/capabilities/page_loading_strategy/" ] --- - -为了通过Selenium WebDriver创建新会话, -本地端应向远程端提供基本功能. -远端使用相同的功能集来创建会话并描述当前会话功能. - -WebDriver提供了每个远程端将 (或应该) 支持实现的功能. -以下是WebDriver支持的功能: +In Selenium 3, capabilities were defined in a session by using Desired Capabilities classes. +As of Selenium 4, you must use the browser options classes. +For remote driver sessions, a browser options instance is required as it determines which browser will be used. + +These options are described in the w3c specification for [Capabilities](https://w3c.github.io/webdriver/#capabilities). + +Each browser has [custom options]() that may be defined in addition to the ones defined in the specification. ## browserName diff --git a/website_and_docs/content/documentation/webdriver/remote_webdriver.en.md b/website_and_docs/content/documentation/webdriver/drivers/remote_webdriver.en.md similarity index 99% rename from website_and_docs/content/documentation/webdriver/remote_webdriver.en.md rename to website_and_docs/content/documentation/webdriver/drivers/remote_webdriver.en.md index af66c8e5f07..750d3db5eec 100644 --- a/website_and_docs/content/documentation/webdriver/remote_webdriver.en.md +++ b/website_and_docs/content/documentation/webdriver/drivers/remote_webdriver.en.md @@ -4,6 +4,7 @@ linkTitle: "Remote WebDriver" weight: 10 aliases: [ + "/documentation/en/webdriver/remote_webdriver/", "/documentation/en/remote_webdriver/", "/documentation/en/remote_webdriver/remote_webdriver_client/" ] diff --git a/website_and_docs/content/documentation/webdriver/remote_webdriver.ja.md b/website_and_docs/content/documentation/webdriver/drivers/remote_webdriver.ja.md similarity index 99% rename from website_and_docs/content/documentation/webdriver/remote_webdriver.ja.md rename to website_and_docs/content/documentation/webdriver/drivers/remote_webdriver.ja.md index 979557ebfcf..42e6176ab69 100644 --- a/website_and_docs/content/documentation/webdriver/remote_webdriver.ja.md +++ b/website_and_docs/content/documentation/webdriver/drivers/remote_webdriver.ja.md @@ -4,6 +4,7 @@ linkTitle: "Remote WebDriver" weight: 10 aliases: [ + "/documentation/ja/webdriver/remote_webdriver/", "/documentation/ja/remote_webdriver/", "/documentation/ja/remote_webdriver/remote_webdriver_client/" ] diff --git a/website_and_docs/content/documentation/webdriver/remote_webdriver.pt-br.md b/website_and_docs/content/documentation/webdriver/drivers/remote_webdriver.pt-br.md similarity index 99% rename from website_and_docs/content/documentation/webdriver/remote_webdriver.pt-br.md rename to website_and_docs/content/documentation/webdriver/drivers/remote_webdriver.pt-br.md index 96ae987c21e..38b72b9db6f 100644 --- a/website_and_docs/content/documentation/webdriver/remote_webdriver.pt-br.md +++ b/website_and_docs/content/documentation/webdriver/drivers/remote_webdriver.pt-br.md @@ -4,6 +4,7 @@ linkTitle: "Remote WebDriver" weight: 10 aliases: [ + "/documentation/pt-br/webdriver/remote_webdriver/", "/documentation/pt-br/remote_webdriver/", "/documentation/pt-br/remote_webdriver/remote_webdriver_client/" ] diff --git a/website_and_docs/content/documentation/webdriver/remote_webdriver.zh-cn.md b/website_and_docs/content/documentation/webdriver/drivers/remote_webdriver.zh-cn.md similarity index 99% rename from website_and_docs/content/documentation/webdriver/remote_webdriver.zh-cn.md rename to website_and_docs/content/documentation/webdriver/drivers/remote_webdriver.zh-cn.md index dcc36fe0036..a65554d5b77 100644 --- a/website_and_docs/content/documentation/webdriver/remote_webdriver.zh-cn.md +++ b/website_and_docs/content/documentation/webdriver/drivers/remote_webdriver.zh-cn.md @@ -4,6 +4,7 @@ linkTitle: "远程WebDriver" weight: 10 aliases: [ + "/documentation/zh-cn/webdriver/remote_webdriver/", "/documentation/zh-cn/remote_webdriver/", "/documentation/zh-cn/remote_webdriver/remote_webdriver_client/" ] diff --git a/website_and_docs/content/documentation/webdriver/drivers/service.en.md b/website_and_docs/content/documentation/webdriver/drivers/service.en.md new file mode 100644 index 00000000000..1a6b6f7460b --- /dev/null +++ b/website_and_docs/content/documentation/webdriver/drivers/service.en.md @@ -0,0 +1,14 @@ +--- +title: "Browser Service" +linkTitle: "Service" +weight: 3 +--- + +The Service classes are for managing the starting and stopping of drivers. +They are not applicable in Remote Drivers. + +* Location of the driver +* port to use +* command line arguments to use + +{{< alert-code />}} diff --git a/website_and_docs/content/documentation/webdriver/drivers/service.ja.md b/website_and_docs/content/documentation/webdriver/drivers/service.ja.md new file mode 100644 index 00000000000..1a6b6f7460b --- /dev/null +++ b/website_and_docs/content/documentation/webdriver/drivers/service.ja.md @@ -0,0 +1,14 @@ +--- +title: "Browser Service" +linkTitle: "Service" +weight: 3 +--- + +The Service classes are for managing the starting and stopping of drivers. +They are not applicable in Remote Drivers. + +* Location of the driver +* port to use +* command line arguments to use + +{{< alert-code />}} diff --git a/website_and_docs/content/documentation/webdriver/drivers/service.pt-br.md b/website_and_docs/content/documentation/webdriver/drivers/service.pt-br.md new file mode 100644 index 00000000000..1a6b6f7460b --- /dev/null +++ b/website_and_docs/content/documentation/webdriver/drivers/service.pt-br.md @@ -0,0 +1,14 @@ +--- +title: "Browser Service" +linkTitle: "Service" +weight: 3 +--- + +The Service classes are for managing the starting and stopping of drivers. +They are not applicable in Remote Drivers. + +* Location of the driver +* port to use +* command line arguments to use + +{{< alert-code />}} diff --git a/website_and_docs/content/documentation/webdriver/drivers/service.zh-cn.md b/website_and_docs/content/documentation/webdriver/drivers/service.zh-cn.md new file mode 100644 index 00000000000..1a6b6f7460b --- /dev/null +++ b/website_and_docs/content/documentation/webdriver/drivers/service.zh-cn.md @@ -0,0 +1,14 @@ +--- +title: "Browser Service" +linkTitle: "Service" +weight: 3 +--- + +The Service classes are for managing the starting and stopping of drivers. +They are not applicable in Remote Drivers. + +* Location of the driver +* port to use +* command line arguments to use + +{{< alert-code />}} diff --git a/website_and_docs/content/documentation/webdriver/getting_started/open_browser.en.md b/website_and_docs/content/documentation/webdriver/getting_started/open_browser.en.md index 76576c91e06..3711768d456 100644 --- a/website_and_docs/content/documentation/webdriver/getting_started/open_browser.en.md +++ b/website_and_docs/content/documentation/webdriver/getting_started/open_browser.en.md @@ -13,7 +13,7 @@ you can start and stop a session with a browser. Typically, browsers are started with specific options that describe which capabilities the browser must support, and how the browser should behave during the session. Some capabilities are -[shared by all browsers]({{< ref "/documentation/webdriver/capabilities/shared.md" >}}), and +[shared by all browsers]({{< ref "/documentation/webdriver/drivers/options.md" >}}), and some will be specific to the browser being used. This page will show examples of starting a browser with the default capabilities. @@ -25,7 +25,7 @@ After learning how to start a session, check out the next session on how to By default, Selenium 4 is compatible with Chrome v75 and greater. Note that the version of the Chrome browser and the version of chromedriver must match the major version. -In addition to the [shared capabilities]({{< ref "/documentation/webdriver/capabilities/shared.md" >}}), +In addition to the [shared capabilities]({{< ref "/documentation/webdriver/drivers/options.md" >}}), there are specific [Chrome capabilities]({{< ref "/documentation/webdriver/capabilities/chromium.md" >}}) that can be used. diff --git a/website_and_docs/content/documentation/webdriver/getting_started/open_browser.ja.md b/website_and_docs/content/documentation/webdriver/getting_started/open_browser.ja.md index df857a458d7..4f6d8e3b418 100644 --- a/website_and_docs/content/documentation/webdriver/getting_started/open_browser.ja.md +++ b/website_and_docs/content/documentation/webdriver/getting_started/open_browser.ja.md @@ -14,7 +14,7 @@ you can start and stop a session with a browser. Typically, browsers are started with specific options that describe which capabilities the browser must support, and how the browser should behave during the session. Some capabilities are -[shared by all browsers]({{< ref "/documentation/webdriver/capabilities/shared.md" >}}), and +[shared by all browsers]({{< ref "/documentation/webdriver/drivers/options.md" >}}), and some will be specific to the browser being used. This page will show examples of starting a browser with the default capabilities. @@ -26,7 +26,7 @@ After learning how to start a session, check out the next session on how to By default, Selenium 4 is compatible with Chrome v75 and greater. Note that the version of the Chrome browser and the version of chromedriver must match the major version. -In addition to the [shared capabilities]({{< ref "/documentation/webdriver/capabilities/shared.md" >}}), +In addition to the [shared capabilities]({{< ref "/documentation/webdriver/drivers/options.md" >}}), there are specific [Chrome capabilities]({{< ref "/documentation/webdriver/capabilities/chromium.md" >}}) that can be used. diff --git a/website_and_docs/content/documentation/webdriver/getting_started/open_browser.pt-br.md b/website_and_docs/content/documentation/webdriver/getting_started/open_browser.pt-br.md index 4ac54fc8ac1..776ab4c80bc 100644 --- a/website_and_docs/content/documentation/webdriver/getting_started/open_browser.pt-br.md +++ b/website_and_docs/content/documentation/webdriver/getting_started/open_browser.pt-br.md @@ -9,7 +9,7 @@ description: > Assim que você tiver a [biblioteca Selenium instalada]({{< ref "install_library.md" >}}), e o [driver do seu navegador de internet preferido]({{< ref "install_drivers.md" >}}), você pode iniciar e parar uma sessão com o navegador de internet. -Normalmente, os navegadores são iniciados com opções específicas que descrevem quais recursos o navegador deve suportar e como o navegador deve se comportar durante a sessão. Alguns recursos são [compartilhados por todos os navegadores de internet]({{< ref "/documentation/webdriver/capabilities/shared.md" >}}), já +Normalmente, os navegadores são iniciados com opções específicas que descrevem quais recursos o navegador deve suportar e como o navegador deve se comportar durante a sessão. Alguns recursos são [compartilhados por todos os navegadores de internet]({{< ref "/documentation/webdriver/drivers/options.md" >}}), já outros serão exclusivos para o navegador de internet que está sendo usado. Esta página mostrará exemplos de como iniciar um navegador de internet com os recursos padrões. @@ -20,7 +20,7 @@ Depois de você aprender como iniciar uma sessão, confira a próxima sessão so Por padrão, o Selenium 4 é compativel com o Chrome v75 e versões superiores. Observe que a versão do navegador de internet Chrome e a versão do chromedriver precisam corresponder à versão principal. -Além dos [recursos compartilhados]({{< ref "/documentation/webdriver/capabilities/shared.md" >}}), +Além dos [recursos compartilhados]({{< ref "/documentation/webdriver/drivers/options.md" >}}), existem [recursos Chrome]({{< ref "/documentation/webdriver/capabilities/chromium.md" >}}) exclusivos que podem ser utilizados. diff --git a/website_and_docs/content/documentation/webdriver/getting_started/open_browser.zh-cn.md b/website_and_docs/content/documentation/webdriver/getting_started/open_browser.zh-cn.md index 7fa04a92173..4adb1d29792 100644 --- a/website_and_docs/content/documentation/webdriver/getting_started/open_browser.zh-cn.md +++ b/website_and_docs/content/documentation/webdriver/getting_started/open_browser.zh-cn.md @@ -13,7 +13,7 @@ description: > 通常, 浏览器都是根据特定的选项启动, 这些选项描述浏览器必须支持哪些功能, 以及浏览器在会话期间应如何运行. -有些功能由[所有浏览器共享]({{< ref "/documentation/webdriver/capabilities/shared.md" >}}), +有些功能由[所有浏览器共享]({{< ref "/documentation/webdriver/drivers/options.md" >}}), 有些功能特定于所使用的浏览器. 此页面将显示使用默认功能启动浏览器的示例. @@ -26,7 +26,7 @@ description: > 默认情况下, Selenium 4与Chrome v75及更高版本兼容. 请注意, Chrome浏览器和chromedriver的版本必须与主版本匹配. -除了[共享功能]({{< ref "/documentation/webdriver/capabilities/shared.md" >}})外, +除了[共享功能]({{< ref "/documentation/webdriver/drivers/options.md" >}})外, 还可以使用特定的[Chrome功能]({{< ref "/documentation/webdriver/capabilities/chromium.md" >}}). {{< tabpane langEqualsHeader=true code=false >}} diff --git a/website_and_docs/content/documentation/webdriver/waits.en.md b/website_and_docs/content/documentation/webdriver/waits.en.md index c74bb9ed74d..4d145a8bcee 100644 --- a/website_and_docs/content/documentation/webdriver/waits.en.md +++ b/website_and_docs/content/documentation/webdriver/waits.en.md @@ -84,7 +84,7 @@ assert(element.text == "Hello from JavaScript!") {{< /tabpane >}} The issue here is that the default -[page load strategy]({{< ref "capabilities/shared#pageloadstrategy" >}}) +[page load strategy]({{< ref "drivers/options#pageloadstrategy" >}}) used in WebDriver listens for the `document.readyState` to change to `"complete"` before returning from the call to _navigate_. Because the `p` element is diff --git a/website_and_docs/content/documentation/webdriver/waits.ja.md b/website_and_docs/content/documentation/webdriver/waits.ja.md index 6550fb14147..463b2e1576c 100644 --- a/website_and_docs/content/documentation/webdriver/waits.ja.md +++ b/website_and_docs/content/documentation/webdriver/waits.ja.md @@ -75,7 +75,7 @@ assert(element.text == "Hello from JavaScript!") {{< /tab >}} {{< /tabpane >}} -ここでは、WebDriverで使用されるデフォルトの [ページロード戦略]({{< ref "capabilities/shared#pageloadstrategy" >}}) が`document.readyState`をリッスンして、ナビゲーションの呼び出しから戻る前に`"complete"`に変更することが問題です。ドキュメントの読み込みが完了した後に`p`要素が追加されるため、このWebDriverスクリプトは断続的になる _可能性があります。_ これらのイベントを明示的に待機（またはブロック）せずに非同期でトリガーする要素またはイベントについては保証できないため、断続的である可能性があります。 +ここでは、WebDriverで使用されるデフォルトの [ページロード戦略]({{< ref "drivers/options#pageloadstrategy" >}}) が`document.readyState`をリッスンして、ナビゲーションの呼び出しから戻る前に`"complete"`に変更することが問題です。ドキュメントの読み込みが完了した後に`p`要素が追加されるため、このWebDriverスクリプトは断続的になる _可能性があります。_ これらのイベントを明示的に待機（またはブロック）せずに非同期でトリガーする要素またはイベントについては保証できないため、断続的である可能性があります。 幸いなことに、 _WebElement.click_ や _WebElement.sendKeys_ などのWebElementインターフェイスで使用可能な通常の命令セットを使用すると、コマンドの呼び出しがブラウザーで完了するまで関数呼び出しが返されない（または、コールバックはコールバックスタイルの言語ではトリガーされない）ため、同期が保証されます。高度なユーザーインタラクションAPIである[_キーボード_]({{< ref "actions_api/keyboard.md" >}})と[_マウス_]({{< ref "actions_api/mouse.md" >}})は、 "言うことをする" 非同期コマンドとして明示的に意図されているため、例外です。 diff --git a/website_and_docs/content/documentation/webdriver/waits.pt-br.md b/website_and_docs/content/documentation/webdriver/waits.pt-br.md index 1610d396c93..487fcd8650a 100644 --- a/website_and_docs/content/documentation/webdriver/waits.pt-br.md +++ b/website_and_docs/content/documentation/webdriver/waits.pt-br.md @@ -84,7 +84,7 @@ assert(element.text == "Hello from JavaScript!") {{< /tabpane >}} O problema aqui é que a -[estratégia de carregamento de página padrão]({{< ref "capabilities/shared#pageloadstrategy" >}}) +[estratégia de carregamento de página padrão]({{< ref "drivers/options#pageloadstrategy" >}}) usado no WebDriver escuta o `document.readyState` para mudar para `"complete"` antes de retornar da chamada para _navigate_. Porque o elemento `p` é diff --git a/website_and_docs/content/documentation/webdriver/waits.zh-cn.md b/website_and_docs/content/documentation/webdriver/waits.zh-cn.md index b70ac563b94..3bca11b52dd 100644 --- a/website_and_docs/content/documentation/webdriver/waits.zh-cn.md +++ b/website_and_docs/content/documentation/webdriver/waits.zh-cn.md @@ -72,7 +72,7 @@ assert(element.text == "Hello from JavaScript!") {{< /tab >}} {{< /tabpane >}} -这里的问题是WebDriver中使用的默认页面加载策略[页面加载策略]({{< ref "capabilities/shared#pageloadstrategy" >}})听从`document.readyState`在返回调用 _navigate_ 之前将状态改为`"complete"` 。因为`p`元素是在文档完成加载之后添加的，所以这个WebDriver脚本可能是间歇性的。它“可能”间歇性是因为无法做出保证说异步触发这些元素或事件不需要显式等待或阻塞这些事件。 +这里的问题是WebDriver中使用的默认页面加载策略[页面加载策略]({{< ref "drivers/options#pageloadstrategy" >}})听从`document.readyState`在返回调用 _navigate_ 之前将状态改为`"complete"` 。因为`p`元素是在文档完成加载之后添加的，所以这个WebDriver脚本可能是间歇性的。它“可能”间歇性是因为无法做出保证说异步触发这些元素或事件不需要显式等待或阻塞这些事件。 幸运的是，[_WebElement_]({{< ref "elements" >}})接口上可用的正常指令集——例如 _WebElement.click_ 和 _WebElement.sendKeys_—是保证同步的，因为直到命令在浏览器中被完成之前函数调用是不会返回的(或者回调是不会在回调形式的语言中触发的)。高级用户交互APIs,[_键盘_]({{< ref "actions_api/keyboard.md" >}})和[_鼠标_]({{< ref "actions_api/mouse.md" >}})是例外的，因为它们被明确地设计为“按我说的做”的异步命令。