skills.md

Selenium Skills & Best Practices

This guide provides a comprehensive overview of how to write effective Selenium tests in various languages and lists industry-standard best practices.

Language Setup & Examples

Java

• Dependencies (Maven):

  <dependency>
      <groupId>org.seleniumhq.selenium</groupId>
      <artifactId>selenium-java</artifactId>
      <version>4.x.x</version>
  </dependency>
  

• Example:

  import org.openqa.selenium.WebDriver;
  import org.openqa.selenium.chrome.ChromeDriver;
  import org.openqa.selenium.chrome.ChromeOptions;
  
  public class SeleniumTest {
      public static void main(String[] args) {
          ChromeOptions options = new ChromeOptions();
          WebDriver driver = new ChromeDriver(options);
          try {
              driver.get("https://www.selenium.dev/");
              System.out.println("Title: " + driver.getTitle());
          } finally {
              driver.quit();
          }
      }
  }
  

JavaScript (Node.js)

• Installation: npm install selenium-webdriver

• Example:

  const {Builder} = require('selenium-webdriver');
  
  (async function example() {
    let driver = await new Builder().forBrowser('chrome').build();
    try {
      await driver.get('https://www.selenium.dev/');
      console.log('Title:', await driver.getTitle());
    } finally {
      await driver.quit();
    }
  })();
  

Python

• Installation: pip install selenium

• Example:

  from selenium import webdriver
  from selenium.webdriver.chrome.options import Options
  
  options = Options()
  driver = webdriver.Chrome(options=options)
  try:
      driver.get("https://www.selenium.dev/")
      print("Title:", driver.title)
  finally:
      driver.quit()
  

.NET (C#)

• NuGet: dotnet add package Selenium.WebDriver

• Example:

  using OpenQA.Selenium;
  using OpenQA.Selenium.Chrome;
  
  using (IWebDriver driver = new ChromeDriver()) {
      driver.Navigate().GoToUrl("https://www.selenium.dev/");
      Console.WriteLine("Title: " + driver.Title);
  }
  

Ruby

• Gem: gem install selenium-webdriver

• Example:

  require 'selenium-webdriver'
  
  driver = Selenium::WebDriver.for :chrome
  begin
    driver.navigate.to "https://www.selenium.dev/"
    puts "Title: #{driver.title}"
  ensure
    driver.quit
  end
  

Best Practices

1. Avoid fixed sleeps

Static sleeps make tests slow and flaky. Instead, use Explicit Waits (WebDriverWait) to wait for specific conditions (e.g., element visibility, title contains). Language-specific sleep calls to avoid:

• Java: Thread.sleep()

• Python: time.sleep()

• Ruby: sleep()

• JavaScript: setTimeout() / await new Promise(r => setTimeout(r, ms))

• C#: Thread.Sleep()

2. Page Object Model (POM)

Organize your tests by grouping elements and actions of each page into separate classes. This makes tests more readable and easier to maintain when the UI changes.

3. Test Independence

Each test should be able to run on its own, regardless of the order in which they are executed. Avoid relying on the side effects of previous tests. Use setup and teardown methods to manage state.

4. Efficient Selectors

• Prefer ID and Name when available.

• Use CSS Selectors for complex queries.

• Avoid XPath unless absolutely necessary (e.g., navigating to parent or sibling nodes) as it's generally slower and more fragile.

5. Always Quit

Always call driver.quit() to ensure browser processes are cleaned up, even if a test fails. Use language-specific constructs like try-finally or using blocks.

6. Use Selenium Manager

You're already using it! Selenium Manager (this tool) automatically downloads and configures the correct drivers and browsers for you, so you don't have to manage binaries manually.