| # 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)**: | |
| ```xml | |
| <dependency> | |
| <groupId>org.seleniumhq.selenium</groupId> | |
| <artifactId>selenium-java</artifactId> | |
| <version>4.x.x</version> | |
| </dependency> | |
| ``` | |
| - **Example**: | |
| ```java | |
| 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**: | |
| ```javascript | |
| 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**: | |
| ```python | |
| 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**: | |
| ```csharp | |
| 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**: | |
| ```ruby | |
| 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. |