Merge branch 'trunk' into petesong/add-practice-example

examples/python/tests/drivers/test_options.py

@@ -5,95 +5,101 @@
 
 def test_page_load_strategy_normal():
     options = webdriver.ChromeOptions()
-
     options.page_load_strategy = 'normal'
     driver = webdriver.Chrome(options=options)
-
     driver.get("https://www.selenium.dev/")
     driver.quit()
 
 
 def test_page_load_strategy_eager():
     options = webdriver.ChromeOptions()
-
     options.page_load_strategy = 'eager'
     driver = webdriver.Chrome(options=options)
-
     driver.get("https://www.selenium.dev/")
     driver.quit()
 
 
 def test_page_load_strategy_none():
     options = webdriver.ChromeOptions()
-
     options.page_load_strategy = 'none'
     driver = webdriver.Chrome(options=options)
-
-    driver.get("https://www.selenium.dev/")
-    driver.quit()
-
-def test_capabilities():
-    options = webdriver.ChromeOptions()
-    options.browser_version = 'stable'
-    options.platform_name = 'any'
-    options.accept_insecure_certs = True
-    driver = webdriver.Chrome(options=options)
-
     driver.get("https://www.selenium.dev/")
     driver.quit()
 
 def test_timeouts_script():
     options = webdriver.ChromeOptions()
     options.timeouts = { 'script': 5000 }
     driver = webdriver.Chrome(options=options)
-
     driver.get("https://www.selenium.dev/")
     driver.quit()
 
 def test_timeouts_page_load():
     options = webdriver.ChromeOptions()
     options.timeouts = { 'pageLoad': 5000 }
     driver = webdriver.Chrome(options=options)
-
     driver.get("https://www.selenium.dev/")
     driver.quit()
 
 def test_timeouts_implicit_wait():
     options = webdriver.ChromeOptions()
     options.timeouts = { 'implicit': 5000 }
     driver = webdriver.Chrome(options=options)
-
     driver.get("https://www.selenium.dev/")
     driver.quit()
 
 def test_unhandled_prompt():
     options = webdriver.ChromeOptions()
     options.unhandled_prompt_behavior = 'accept'
     driver = webdriver.Chrome(options=options)
-
     driver.get("https://www.selenium.dev/")
     driver.quit()
 
 def test_set_window_rect():
     options = webdriver.FirefoxOptions()
     options.set_window_rect = True # Full support in Firefox
     driver = webdriver.Firefox(options=options)
-
     driver.get("https://www.selenium.dev/")
     driver.quit()
 
 def test_strict_file_interactability():
     options = webdriver.ChromeOptions()
     options.strict_file_interactability = True
     driver = webdriver.Chrome(options=options)
-
     driver.get("https://www.selenium.dev/")
     driver.quit()
 
 def test_proxy():
     options = webdriver.ChromeOptions()
     options.proxy = Proxy({ 'proxyType': ProxyType.MANUAL, 'httpProxy' : 'http.proxy:1234'})
     driver = webdriver.Chrome(options=options)
-
     driver.get("https://www.selenium.dev/")
-    driver.quit()
+    driver.quit()
+
+def test_set_browser_name():
+    options = webdriver.ChromeOptions()
+    assert options.capabilities['browserName'] == 'chrome'
+    driver = webdriver.Chrome(options=options)
+    driver.get("https://www.selenium.dev/")
+    driver.quit()
+
+def test_set_browser_version():
+    options = webdriver.ChromeOptions()
+    options.browser_version = 'latest'
+    assert options.capabilities['browserVersion'] == 'latest'
+    driver = webdriver.Chrome(options=options)
+    driver.get("https://www.selenium.dev/")
+    driver.quit()
+
+def test_platform_name():
+    options = webdriver.ChromeOptions()
+    options.platform_name = 'any'
+    driver = webdriver.Chrome(options=options)
+    driver.get("https://www.selenium.dev/")
+    driver.quit()
+
+def test_accept_insecure_certs():
+    options = webdriver.ChromeOptions()
+    options.accept_insecure_certs = True
+    driver = webdriver.Chrome(options=options)
+    driver.get("https://www.selenium.dev/")
+    driver.quit()

examples/python/tests/interactions/test_prints_page.py

@@ -0,0 +1,15 @@
+import pytest
+from selenium import webdriver
+from selenium.webdriver.common.print_page_options import PrintOptions
+
+pytest.fixture()
+def driver():
+    driver = webdriver.Chrome()
+    yield driver
+    driver.quit()
+
+def test_prints_page(driver):
+    driver.get("https://www.selenium.dev/")
+    print_options = PrintOptions()
+    pdf = driver.print_page(print_options)
+    assert len(pdf) > 0

website_and_docs/content/blog/2024/selenium-milestone-20yrs-blog.md

@@ -42,3 +42,14 @@ Join Us in Celebrating Selenium’s Incredible Journey!
 For 20 years, Selenium has helped shape how we test, automate, and innovate on the web. This is your opportunity to celebrate that legacy and learn what the future holds for browser automation. We can’t wait to see you there!
 Event Organizers - **<a href="https://www.linkedin.com/in/maaret/" target="_blank">Maaret</a>**, **<a href="https://www.linkedin.com/in/diemol/" target="_blank">Diego</a>**, and **<a href="https://www.linkedin.com/in/pallavimuse/" target="_blank">Pallavi</a>**. 
 
+## Watch the Recording of Our 20th Anniversary Event
+
+Couldn’t join us live? Watch the entire **"Celebrating 20 Years of Selenium"** 
+event on YouTube. Relive the milestone moments, hear directly from 
+the Selenium leadership team, and get insights into the future of browser automation.
+
+📹 Recording Link: [Watch the Event Recording on YouTube](https://www.youtube.com/watch?v=TO-ZCl2LZ50)
+
+This recording covers the highlights, including discussions on Selenium’s evolution, 
+its role in the testing ecosystem, and the exciting advancements in WebDriver BiDi.
+

website_and_docs/content/documentation/webdriver/drivers/options.en.md

@@ -34,7 +34,7 @@ Browser name is set by default when using an Options class instance.
 {{< gh-codeblock path="examples/java/src/test/java/dev/selenium/drivers/OptionsTest.java#L73-74" >}}
 {{< /tab >}}
 {{% tab header="Python" %}}
-{{< gh-codeblock path="examples/python/tests/drivers/test_options.py#L36" >}}
+{{< gh-codeblock path="examples/python/tests/drivers/test_options.py#L79-80" >}}
 {{% /tab %}}
 {{< tab header="CSharp" >}}
 {{< badge-code >}}
@@ -61,7 +61,7 @@ it will be automatically downloaded by [Selenium Manager]({{< ref "../../seleniu
 {{< gh-codeblock path="examples/java/src/test/java/dev/selenium/drivers/OptionsTest.java#L80-82" >}}
 {{< /tab >}}
 {{% tab header="Python" %}}
-{{< gh-codeblock path="examples/python/tests/drivers/test_options.py#L37" >}}
+{{< gh-codeblock path="examples/python/tests/drivers/test_options.py#L86-88" >}}
 {{% /tab %}}
 {{< tab header="CSharp" >}}
 {{< badge-code >}}
@@ -117,7 +117,7 @@ event fire is returned.
 {{< gh-codeblock path="/examples/java/src/test/java/dev/selenium/drivers/OptionsTest.java#L21-L23">}}
 {{< /tab >}}
 {{< tab header="Python" text=true >}}
-{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L9-L10">}}
+{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L7-9">}}
 {{< /tab >}}
 {{< tab header="CSharp" >}}
 using OpenQA.Selenium;
@@ -174,7 +174,7 @@ event fire is returned.
 {{< gh-codeblock path="/examples/java/src/test/java/dev/selenium/drivers/OptionsTest.java#L34-L36">}}
 {{< /tab >}}
 {{< tab header="Python" text=true >}}
-{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L19-L20">}}
+{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L15-L17">}}
 {{< /tab >}}
 {{< tab header="CSharp" >}}
 using OpenQA.Selenium;
@@ -230,7 +230,7 @@ WebDriver only waits until the initial page is downloaded.
 {{< gh-codeblock path="/examples/java/src/test/java/dev/selenium/drivers/OptionsTest.java#L47-L49">}}
 {{< /tab >}}
 {{< tab header="Python" text=true >}}
-{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L29-L30">}}
+{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L23-L25">}}
 {{< /tab >}}
 {{< tab header="CSharp" >}}
 using OpenQA.Selenium;
@@ -290,7 +290,7 @@ setting `platformName` sets the OS at the remote-end.
 {{< gh-codeblock path="/examples/java/src/test/java/dev/selenium/drivers/OptionsTest.java#L88-L90">}}
 {{< /tab >}}
 {{% tab header="Python" %}}
-{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L38">}}
+{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L94-96">}}
 {{% /tab %}}
 {{< tab header="CSharp" >}}
 {{< badge-code >}}
@@ -328,7 +328,7 @@ effect for the entire session.
 {{< gh-codeblock path="/examples/java/src/test/java/dev/selenium/drivers/OptionsTest.java#L60-L61">}}
 {{< /tab >}}
 {{% tab header="Python" %}}
-{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L39-40">}}
+{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L101-103">}}
 {{% /tab %}}
 {{< tab header="CSharp" >}}
 {{< badge-code >}}
@@ -363,7 +363,7 @@ is imposed when a new session is created by WebDriver.
 {{< gh-codeblock path="/examples/java/src/test/java/dev/selenium/drivers/OptionsTest.java#L96-L98">}}
 {{< /tab >}}
 {{% tab header="Python" %}}
-{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L47-48">}}
+{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L30-32">}}
 {{% /tab %}}
 {{< tab header="CSharp" >}}
 {{< badge-code >}}
@@ -392,7 +392,7 @@ _TimeoutException_.
 {{< gh-codeblock path="/examples/java/src/test/java/dev/selenium/drivers/OptionsTest.java#L111-L113">}}
 {{< /tab >}}
 {{% tab header="Python" %}}
-{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L55-56">}}
+{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L37-39">}}
 {{% /tab %}}
 {{< tab header="CSharp" >}}
 {{< badge-code >}}
@@ -419,7 +419,7 @@ is imposed when a new session is created by WebDriver.
 {{< gh-codeblock path="/examples/java/src/test/java/dev/selenium/drivers/OptionsTest.java#L126-L128">}}
 {{< /tab >}}
 {{% tab header="Python" %}}
-{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L63-64">}}
+{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L44-46">}}
 {{% /tab %}}
 {{< tab header="CSharp" >}}
 {{< badge-code >}}
@@ -457,7 +457,7 @@ user prompt encounters at the remote-end. This is defined by
 {{< gh-codeblock path="/examples/java/src/test/java/dev/selenium/drivers/OptionsTest.java#L141-L142">}}
 {{< /tab >}}
 {{% tab header="Python" %}}
-{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L71-72">}}
+{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L51-53">}}
 {{% /tab %}}
 {{< tab header="CSharp" >}}
 {{< badge-code >}}
@@ -482,7 +482,7 @@ Indicates whether the remote end supports all of the [resizing and repositioning
 {{< gh-codeblock path="/examples/java/src/test/java/dev/selenium/drivers/OptionsTest.java#L151-L152">}}
 {{< /tab >}}
 {{% tab header="Python" %}}
-{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L79-80">}}
+{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L58-60">}}
 {{% /tab %}}
 {{< tab header="CSharp" >}}
 {{< badge-code >}}
@@ -510,7 +510,7 @@ when using _Element Send Keys_ with hidden file upload controls.
 {{< gh-codeblock path="/examples/java/src/test/java/dev/selenium/drivers/OptionsTest.java#L163-L164">}}
 {{< /tab >}}
 {{% tab header="Python" %}}
-{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L87-88">}}
+{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L65-67">}}
 {{% /tab %}}
 {{< tab header="CSharp" >}}
 {{< badge-code >}}
@@ -571,7 +571,7 @@ public class ProxyTest {
 ```
 {{% /tab %}}
 {{% tab header="Python" %}}
-{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L95-96">}}
+{{< gh-codeblock path="/examples/python/tests/drivers/test_options.py#L72-74">}}
 {{% /tab %}}
 {{% tab header="CSharp" %}}
 ```CSharp