Skip to content

Latest commit

 

History

History
82 lines (66 loc) · 3.06 KB

File metadata and controls

82 lines (66 loc) · 3.06 KB
title Driver Sessions
linkTitle Drivers
weight 3

Starting and stopping a session is for opening and closing a browser.

Creating Sessions

Creating a new session corresponds with the W3C command for 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 [HTTP Client configuration]({{< ref "http_client.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

{{< tabpane text=true >}} {{< tab header="Java" >}} {{< gh-codeblock path="/examples/java/src/test/java/dev/selenium/drivers/OptionsTest.java#L23" >}} {{< /tab >}} {{% tab header="Python" %}} {{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L9" >}} {{% /tab %}} {{< tab header="CSharp" >}} {{< gh-codeblock path="/examples/dotnet/SeleniumDocs/BaseTest.cs#L42" >}} {{< /tab >}} {{< tab header="Ruby" >}} {{< gh-codeblock path="/examples/ruby/spec/drivers/options_spec.rb#L14" >}} {{< /tab >}} {{< tab header="JavaScript" >}} {{< gh-codeblock path="/examples/javascript/test/drivers/service.spec.js#L46-L50" >}} {{< /tab >}} {{< tab header="Kotlin" >}} {{< badge-code >}} {{< /tab >}} {{< /tabpane >}}

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]({{< ref "remote_webdriver.md" >}})

Quitting Sessions

Quitting a session corresponds to W3C command for Deleting a Session.

Important note: the quit method is different from the close method, and it is recommended to always use quit to end the session

{{< tabpane text=true >}} {{< tab header="Java" >}} {{< gh-codeblock path="/examples/java/src/test/java/dev/selenium/getting_started/FirstScript.java#L29" >}} {{< /tab >}} {{% tab header="Python" %}} {{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L11" >}} {{% /tab %}} {{< tab header="CSharp" >}} {{< gh-codeblock path="/examples/dotnet/SeleniumDocs/GettingStarted/FirstScript.cs#L28" >}} {{< /tab >}} {{< tab header="Ruby" >}} {{< gh-codeblock path="/examples/ruby/spec/drivers/options_spec.rb#L16" >}} {{< /tab >}} {{< tab header="JavaScript" >}} {{< gh-codeblock path="/examples/javascript/test/getting_started/firstScript.spec.js#L28" >}} {{< /tab >}} {{< tab header="Kotlin" >}} {{< gh-codeblock path="/examples/kotlin/src/test/kotlin/dev/selenium/getting_started/FirstScriptTest.kt#L35" >}} {{< /tab >}} {{< /tabpane >}}