Merge branch 'trunk' into javascript-example-selenium-manager

Author: shbenzer

examples/java/build.gradle

@@ -11,7 +11,7 @@ repositories {
 
 dependencies {
     testImplementation 'org.seleniumhq.selenium:selenium-java:4.25.0'
-    testImplementation 'org.junit.jupiter:junit-jupiter-engine:5.11.1'
+    testImplementation 'org.junit.jupiter:junit-jupiter-engine:5.11.2'
 }
 
 test {

examples/java/pom.xml

@@ -40,7 +40,7 @@
         <dependency>
             <groupId>org.junit.jupiter</groupId>
             <artifactId>junit-jupiter-engine</artifactId>
-            <version>5.11.1</version>
+            <version>5.11.2</version>
             <scope>test</scope>
         </dependency>
         <dependency>

examples/java/src/test/java/dev/selenium/interactions/PrintOptionsTest.java

@@ -0,0 +1,77 @@
+package dev.selenium.interactions;
+
+import org.junit.jupiter.api.Test;
+import org.openqa.selenium.print.PageMargin;
+import org.openqa.selenium.print.PrintOptions;
+
+import dev.selenium.BaseChromeTest;
+
+public class PrintOptionsTest extends BaseChromeTest {
+
+    @Test
+    public void TestOrientation() 
+    {
+        driver.get("https://www.selenium.dev/");
+        PrintOptions printOptions = new PrintOptions();
+        printOptions.setOrientation(PrintOptions.Orientation.LANDSCAPE);
+        PrintOptions.Orientation current_orientation = printOptions.getOrientation();
+    }
+
+    @Test
+    public void TestRange() 
+    {
+        driver.get("https://www.selenium.dev/");
+        PrintOptions printOptions = new PrintOptions();
+        printOptions.setPageRanges("1-2");
+        String[] current_range = printOptions.getPageRanges();
+    }
+
+    @Test
+    public void TestSize() 
+    {
+        driver.get("https://www.selenium.dev/");
+        PrintOptions printOptions = new PrintOptions();
+        printOptions.setScale(.50);
+        double current_scale = printOptions.getScale();
+    }
+
+    @Test
+    public void TestMargins() 
+    {
+        driver.get("https://www.selenium.dev/");
+        PrintOptions printOptions = new PrintOptions();
+        PageMargin margins = new PageMargin(1.0,1.0,1.0,1.0);
+        printOptions.setPageMargin(margins);
+        double topMargin = margins.getTop();
+        double bottomMargin = margins.getBottom();
+        double leftMargin = margins.getLeft();
+        double rightMargin = margins.getRight();
+    }
+
+    @Test
+    public void TestScale() 
+    {
+        driver.get("https://www.selenium.dev/");
+        PrintOptions printOptions = new PrintOptions();
+        printOptions.setScale(.50);
+        double current_scale = printOptions.getScale();
+    }
+
+    @Test
+    public void TestBackground() 
+    {
+        driver.get("https://www.selenium.dev/");
+        PrintOptions printOptions = new PrintOptions();
+        printOptions.setBackground(true);
+        boolean current_background = printOptions.getBackground();
+    }
+
+    @Test
+    public void TestShrinkToFit() 
+    {
+        driver.get("https://www.selenium.dev/");
+        PrintOptions printOptions = new PrintOptions();
+        printOptions.setShrinkToFit(true);
+        boolean current_shrink_to_fit = printOptions.getShrinkToFit();
+    }
+}

examples/kotlin/pom.xml

@@ -9,12 +9,12 @@
     <version>1.0.0</version>
 
     <properties>
-        <kotlin.version>2.0.20</kotlin.version>
+        <kotlin.version>2.0.21</kotlin.version>
 
         <slf4j.version>2.0.16</slf4j.version>
-        <logback.version>1.5.8</logback.version>
+        <logback.version>1.5.10</logback.version>
 
-        <junit5.version>5.11.1</junit5.version>
+        <junit5.version>5.11.2</junit5.version>
         <wdm.version>5.2.3</wdm.version>
 
         <maven-surefire-plugin.version>3.5.1</maven-surefire-plugin.version>

examples/ruby/Gemfile.lock

@@ -41,7 +41,7 @@ GEM
       unicode-display_width (>= 2.4.0, < 3.0)
     rubocop-ast (1.32.3)
       parser (>= 3.3.1.0)
-    rubocop-rspec (3.0.5)
+    rubocop-rspec (3.1.0)
       rubocop (~> 1.61)
     ruby-progressbar (1.13.0)
     rubyzip (2.3.2)
@@ -53,7 +53,7 @@ GEM
       rexml (~> 3.2, >= 3.2.5)
       rubyzip (>= 1.2.2, < 3.0)
       websocket (~> 1.0)
-    unicode-display_width (2.5.0)
+    unicode-display_width (2.6.0)
     websocket (1.2.11)
 
 PLATFORMS

website_and_docs/content/blog/2024/seleniumconf-appiumconf-valencia-2025.md

@@ -0,0 +1,42 @@
+---
+title: "Announcing SeleniumConf & AppiumConf 2025"
+linkTitle: "Announcing SeleniumConf & AppiumConf 2025"
+date: 2024-10-11
+tags: ["conference", "meetup", "workshop"]
+categories: ["conference"]
+author: Diego Molina ([@diemol](https://diemol.com))
+images:
+  - "/images/blog/2024/seleniumconf-appiumconf-featured-img"
+description: >
+  SeleniumConf and AppiumConf are back in person!
+---
+
+We're thrilled to announce that **SeleniumConf & AppiumConf** is returning for 2025, bringing together browser and mobile automation enthusiasts from around the world. This
+must-attend event will take place from **March 26-28, 2025**, in the vibrant city of **Valencia, Spain**!
+
+This year, the conference will gather over **400 browser and mobile automation professionals, including developers, testers, quality managers, test architects**, and others, 
+to explore the latest trends in **browser and mobile automation**, including cutting-edge topics like **AI in automation, game testing, accessibility automation**, and much more. 
+Whether you're new to automation or an experienced professional, this conference is designed to offer **actionable insights and practical knowledge** that you can take back to your team.
+
+## Why Attend?
+
+- **Unparalleled Learning**: Get hands-on training and real-world insights from world-class experts in **Selenium**, **Appium**, and the broader **WebDriver ecosystem**. Learn 
+  how automation tools like **WebdriverIO, Puppeteer, Nightwatch**, and more are pushing the boundaries of testing.
+- **AI & Automation**: Discover how **AI** is reshaping browser and mobile automation and learn practical techniques integrating **AI** into your testing workflows.
+- **Workshops & Networking**: Full-day workshops on March 26 offer deep dives into advanced topics like **Selenium Grid with Kubernetes**, **Advance Appium** or **Selenium Deep Dive**. 
+  Plus, with so many professionals on-site, it's the perfect opportunity to grow your network and meet project leads, committers, and fellow testers.
+- **Scenic Valencia**: All of this will take place at the stunning **[Veles e Vents event building](https://veleseventsvalencia.es/en)**, located right by the Mediterranean Sea. 
+  And don't worry, we've got special hotel rates just for you!
+
+## Mark Your Calendar 🗓️ 
+
+- **Call for Proposals** and **ticket sales** open on **October 15, 2024**. Take your chance to submit a talk or secure your spot at this exciting event!
+- The **conference workshops** will be posted on **October 15, 2024**, so stay tuned! In the meantime, visit **[www.seleniumconf.com](https://www.seleniumconf.com)** for more details and to plan your trip.
+
+## Help Spread the Word!
+
+Excited about SeleniumConf & AppiumConf 2025? **Share this event** with your colleagues, friends, and fellow automation enthusiasts.
+Remember to follow us for updates and visit **[www.seleniumconf.com](https://www.seleniumconf.com)** to learn more.
+
+
+Happy testing!

website_and_docs/content/documentation/test_practices/design_strategies.en.md

@@ -34,7 +34,7 @@ There is currently an implementation in Java that ships as part of Selenium 2, b
 ### Simple Usage
 
 As an example of a UI that we'd like to model, take a look at 
-the [new issue](https://github.com/SeleniumHQ/selenium/issues/new) page. From the point of view of a test author, 
+the [new issue](https://github.com/SeleniumHQ/selenium/issues/new?assignees=&labels=I-defect%2Cneeds-triaging&projects=&template=bug-report.yml&title=%5B%F0%9F%90%9B+Bug%5D%3A+) page. From the point of view of a test author, 
 this offers the service of being able to file a new issue. A basic Page Object would look like:
 
 ```java
@@ -52,18 +52,53 @@ public class EditIssue {
     this.driver = driver;
   }
 
-  public void setSummary(String summary) {
-    WebElement field = driver.findElement(By.name("summary"));
-    clearAndType(field, summary);
+  public void setTitle(String title) {
+    WebElement field = driver.findElement(By.id("issue_title")));
+    clearAndType(field, title);
   }
 
-  public void enterDescription(String description) {
-    WebElement field = driver.findElement(By.name("comment"));
-    clearAndType(field, description);
+  public void setBody(String body) {
+    WebElement field = driver.findElement(By.id("issue_body"));
+    clearAndType(field, body);
+  }
+
+  public void setHowToReproduce(String howToReproduce) {
+    WebElement field = driver.findElement(By.id("issue_form_repro-command"));
+    clearAndType(field, howToReproduce);
+  }
+
+  public void setLogOutput(String logOutput) {
+    WebElement field = driver.findElement(By.id("issue_form_logs"));
+    clearAndType(field, logOutput);
+  }
+
+  public void setOperatingSystem(String operatingSystem) {
+    WebElement field = driver.findElement(By.id("issue_form_operating-system"));
+    clearAndType(field, operatingSystem);
+  }
+
+  public void setSeleniumVersion(String seleniumVersion) {
+    WebElement field = driver.findElement(By.id("issue_form_selenium-version"));
+    clearAndType(field, logOutput);
+  }
+
+  public void setBrowserVersion(String browserVersion) {
+    WebElement field = driver.findElement(By.id("issue_form_browser-versions"));
+    clearAndType(field, browserVersion);
+  }
+
+  public void setDriverVersion(String driverVersion) {
+    WebElement field = driver.findElement(By.id("issue_form_browser-driver-versions"));
+    clearAndType(field, driverVersion);
+  }
+
+  public void setUsingGrid(String usingGrid) {
+    WebElement field = driver.findElement(By.id("issue_form_selenium-grid-version"));
+    clearAndType(field, usingGrid);
   }
 
   public IssueList submit() {
-    driver.findElement(By.id("submit")).click();
+    driver.findElement(By.cssSelector("button[type='submit']")).click();
     return new IssueList(driver);
   }
 
@@ -90,7 +125,7 @@ By extending this base class, we need to implement two new methods:
 ```java
   @Override
   protected void load() {
-    driver.get("https://github.com/SeleniumHQ/selenium/issues/new");
+    driver.get("https://github.com/SeleniumHQ/selenium/issues/new?assignees=&labels=I-defect%2Cneeds-triaging&projects=&template=bug-report.yml&title=%5B%F0%9F%90%9B+Bug%5D%3A+");
   }
 
   @Override
@@ -123,16 +158,13 @@ public class EditIssue extends LoadableComponent<EditIssue> {
   private final WebDriver driver;
 
   // By default the PageFactory will locate elements with the same name or id
-  // as the field. Since the summary element has a name attribute of "summary"
+  // as the field. Since the issue_title element has an id attribute of "issue_title"
   // we don't need any additional annotations.
-  private WebElement summary;
+  private WebElement issue_title;
 
-  // Same with the submit element, which has the ID "submit"
-  private WebElement submit;
-  
-  // But we'd prefer a different name in our code than "comment", so we use the
+  // But we'd prefer a different name in our code than "issue_body", so we use the
   // FindBy annotation to tell the PageFactory how to locate the element.
-  @FindBy(name = "comment") private WebElement description;
+  @FindBy(id = "issue_body") private WebElement body;
 
   public EditIssue(WebDriver driver) {
     this.driver = driver;
@@ -143,25 +175,52 @@ public class EditIssue extends LoadableComponent<EditIssue> {
 
   @Override
   protected void load() {
-    driver.get("https://github.com/SeleniumHQ/selenium/issues/new");
+    driver.get("https://github.com/SeleniumHQ/selenium/issues/new?assignees=&labels=I-defect%2Cneeds-triaging&projects=&template=bug-report.yml&title=%5B%F0%9F%90%9B+Bug%5D%3A+");
   }
 
   @Override
   protected void isLoaded() throws Error {
     String url = driver.getCurrentUrl();
     assertTrue("Not on the issue entry page: " + url, url.endsWith("/new"));
   }
-  
-  public void setSummary(String issueSummary) {
-    clearAndType(summary, issueSummary);
+
+  public void setHowToReproduce(String howToReproduce) {
+    WebElement field = driver.findElement(By.id("issue_form_repro-command"));
+    clearAndType(field, howToReproduce);
+  }
+
+  public void setLogOutput(String logOutput) {
+    WebElement field = driver.findElement(By.id("issue_form_logs"));
+    clearAndType(field, logOutput);
+  }
+
+  public void setOperatingSystem(String operatingSystem) {
+    WebElement field = driver.findElement(By.id("issue_form_operating-system"));
+    clearAndType(field, operatingSystem);
   }
 
-  public void enterDescription(String issueDescription) {
-    clearAndType(description, issueDescription);
+  public void setSeleniumVersion(String seleniumVersion) {
+    WebElement field = driver.findElement(By.id("issue_form_selenium-version"));
+    clearAndType(field, logOutput);
+  }
+
+  public void setBrowserVersion(String browserVersion) {
+    WebElement field = driver.findElement(By.id("issue_form_browser-versions"));
+    clearAndType(field, browserVersion);
+  }
+
+  public void setDriverVersion(String driverVersion) {
+    WebElement field = driver.findElement(By.id("issue_form_browser-driver-versions"));
+    clearAndType(field, driverVersion);
+  }
+
+  public void setUsingGrid(String usingGrid) {
+    WebElement field = driver.findElement(By.id("issue_form_selenium-grid-version"));
+    clearAndType(field, usingGrid);
   }
 
   public IssueList submit() {
-    submit.click();
+    driver.findElement(By.cssSelector("button[type='submit']")).click();
     return new IssueList(driver);
   }
 
@@ -298,7 +357,7 @@ The "load" method in EditIssue now looks like:
   protected void load() {
     securedPage.get();
 
-    driver.get("https://github.com/SeleniumHQ/selenium/issues/new");
+    driver.get("https://github.com/SeleniumHQ/selenium/issues/new?assignees=&labels=I-defect%2Cneeds-triaging&projects=&template=bug-report.yml&title=%5B%F0%9F%90%9B+Bug%5D%3A+");
   }
 ```
 
@@ -323,9 +382,17 @@ public class FooTest {
   public void demonstrateNestedLoadableComponents() {
     editIssue.get();
 
-    editIssue.setSummary("Summary");
-    editIssue.enterDescription("This is an example");
+    editIssue.title.sendKeys('Title');
+    editIssue.body.sendKeys('What Happened');
+    editIssue.setHowToReproduce('How to Reproduce');
+    editIssue.setLogOutput('Log Output');
+    editIssue.setOperatingSystem('Operating System');
+    editIssue.setSeleniumVersion('Selenium Version');
+    editIssue.setBrowserVersion('Browser Version');
+    editIssue.setDriverVersion('Driver Version');
+    editIssue.setUsingGrid('I Am Using Grid');
   }
+
 }
 ```