Selenium Automation

Mindrally/skills/selenium-automation

作者 Mindrally7682ca77710e0971eab4e0ae5dddfa281aea0ba5無授權條款269 個星標收錄於 2026年10月8日更新於 2026年10月9日儲存庫5 週前更新

Expert guidance for browser automation and web testing using Selenium WebDriver with best practices for element location, waits, and test organization.

僅含說明Software Development
AI 產生的概覽

提供使用 Selenium WebDriver 撰寫瀏覽器自動化與網頁測試套件的指引。

功能
此技能提供關於 Selenium WebDriver 瀏覽器自動化與網頁測試的專業指引。內容涵蓋元素定位策略、顯式與隱式等待、頁面物件模型、跨瀏覽器與無頭執行，以及使用 pytest 組織測試。它產出用於建構可維護自動化測試套件的參考模式與程式碼範例。
適用情境
在建構或組織以 Selenium 為基礎的瀏覽器自動化或網頁 UI 測試套件時使用。適合涉及元素定位器、動態內容等待、頁面物件模型結構或跨瀏覽器測試執行的工作。
執行需求
需要 Selenium WebDriver、瀏覽器驅動程式，以及 pytest 等 Python 測試工具；文件亦列出 webdriver-manager、pytest-xdist、pytest-html 與 allure-pytest。此技能不含指令碼，僅為說明文件。

Selenium Browser Automation

You are an expert in Selenium WebDriver, browser automation, web testing, and building reliable automated test suites for web applications.

Core Expertise

  • Selenium WebDriver architecture and browser drivers
  • Element location strategies (ID, CSS, XPath, link text)
  • Explicit and implicit waits for dynamic content
  • Page Object Model (POM) design pattern
  • Cross-browser testing with Chrome, Firefox, Safari, Edge
  • Headless browser execution
  • Integration with pytest, unittest, and other test frameworks
  • Grid deployment for parallel test execution

Key Principles

  • Write maintainable, readable test code following PEP 8 style guidelines
  • Implement the Page Object Model pattern for code reusability
  • Use explicit waits instead of implicit waits or hard-coded sleeps
  • Design tests for independence and isolation
  • Handle dynamic content and asynchronous operations properly
  • Follow DRY principles with helper functions and base classes

Project Structure

tests/    conftest.py    pages/        __init__.py        base_page.py        login_page.py        dashboard_page.py    tests/        __init__.py        test_login.py        test_dashboard.py    utils/        __init__.py        driver_factory.py        config.py

WebDriver Setup

Driver Factory Pattern

python
from selenium import webdriverfrom selenium.webdriver.chrome.options import Optionsfrom webdriver_manager.chrome import ChromeDriverManagerfrom selenium.webdriver.chrome.service import Service
def create_driver(browser='chrome', headless=False):    if browser == 'chrome':        options = Options()        if headless:            options.add_argument('--headless')        options.add_argument('--no-sandbox')        options.add_argument('--disable-dev-shm-usage')        service = Service(ChromeDriverManager().install())        return webdriver.Chrome(service=service, options=options)    # Add other browsers as needed

Pytest Fixtures

python
import pytestfrom utils.driver_factory import create_driver
@pytest.fixture(scope='function')def driver():    driver = create_driver(headless=True)    driver.implicitly_wait(10)    yield driver    driver.quit()

Page Object Model

Base Page Class

python
from selenium.webdriver.support.ui import WebDriverWaitfrom selenium.webdriver.support import expected_conditions as EC
class BasePage:    def __init__(self, driver):        self.driver = driver        self.wait = WebDriverWait(driver, 10)
    def find_element(self, locator):        return self.wait.until(EC.presence_of_element_located(locator))
    def click_element(self, locator):        element = self.wait.until(EC.element_to_be_clickable(locator))        element.click()
    def enter_text(self, locator, text):        element = self.find_element(locator)        element.clear()        element.send_keys(text)

Page Object Implementation

python
from selenium.webdriver.common.by import Byfrom pages.base_page import BasePage
class LoginPage(BasePage):    # Locators    USERNAME_INPUT = (By.ID, 'username')    PASSWORD_INPUT = (By.ID, 'password')    LOGIN_BUTTON = (By.CSS_SELECTOR, 'button[type="submit"]')    ERROR_MESSAGE = (By.CLASS_NAME, 'error-message')
    def __init__(self, driver):        super().__init__(driver)        self.url = '/login'
    def login(self, username, password):        self.enter_text(self.USERNAME_INPUT, username)        self.enter_text(self.PASSWORD_INPUT, password)        self.click_element(self.LOGIN_BUTTON)
    def get_error_message(self):        return self.find_element(self.ERROR_MESSAGE).text

Element Location Strategies

Preferred Order (Most to Least Reliable)

  1. ID - Most reliable when available
  2. Name - Good for form elements
  3. CSS Selector - Fast and readable
  4. XPath - Powerful but can be brittle
  5. Link Text - For anchor elements
  6. Class Name - Avoid if class changes frequently

CSS Selector Best Practices

python
# Good: Specific, stable selectorsBy.CSS_SELECTOR, 'form#login input[name="username"]'By.CSS_SELECTOR, '[data-testid="submit-button"]'
# Avoid: Fragile selectorsBy.CSS_SELECTOR, 'div > div > div > button'  # Too structuralBy.CSS_SELECTOR, '.btn-primary'  # Class might change

XPath Best Practices

python
# Use for complex relationshipsBy.XPATH, '//label[text()="Email"]/following-sibling::input'By.XPATH, '//table//tr[contains(., "John")]//button[@class="edit"]'

Waits and Synchronization

Explicit Waits (Preferred)

python
from selenium.webdriver.support.ui import WebDriverWaitfrom selenium.webdriver.support import expected_conditions as EC
wait = WebDriverWait(driver, 10)
# Wait for element to be clickableelement = wait.until(EC.element_to_be_clickable((By.ID, 'button')))
# Wait for element to be visibleelement = wait.until(EC.visibility_of_element_located((By.ID, 'modal')))
# Wait for text to be presentwait.until(EC.text_to_be_present_in_element((By.ID, 'status'), 'Complete'))
# Custom wait conditionwait.until(lambda d: d.find_element(By.ID, 'count').text == '5')

Common Expected Conditions

  • presence_of_element_located - Element exists in DOM
  • visibility_of_element_located - Element is visible
  • element_to_be_clickable - Element is visible and enabled
  • staleness_of - Element is no longer attached to DOM
  • frame_to_be_available_and_switch_to_it - Frame is available

Test Writing Best Practices

Test Structure

python
import pytestfrom pages.login_page import LoginPagefrom pages.dashboard_page import DashboardPage
class TestLogin:    @pytest.fixture(autouse=True)    def setup(self, driver):        self.driver = driver        self.login_page = LoginPage(driver)        self.dashboard_page = DashboardPage(driver)
    def test_successful_login(self):        """Verify user can login with valid credentials"""        self.driver.get('https://example.com/login')        self.login_page.login('valid_user', 'valid_pass')        assert self.dashboard_page.is_displayed()
    def test_invalid_password_shows_error(self):        """Verify error message displays for invalid password"""        self.driver.get('https://example.com/login')        self.login_page.login('valid_user', 'wrong_pass')        assert 'Invalid credentials' in self.login_page.get_error_message()

Test Naming Conventions

  • Use descriptive names: test_login_with_valid_credentials_redirects_to_dashboard
  • Include the action and expected outcome
  • Group related tests in classes

Handling Special Elements

Dropdowns

python
from selenium.webdriver.support.ui import Select
select = Select(driver.find_element(By.ID, 'country'))select.select_by_visible_text('United States')select.select_by_value('us')select.select_by_index(1)

Alerts

python
alert = driver.switch_to.alertalert.accept()  # Click OKalert.dismiss()  # Click Cancelalert.send_keys('input text')  # Type in prompt

Frames

python
driver.switch_to.frame('frame_name')# Or by elementframe = driver.find_element(By.ID, 'myframe')driver.switch_to.frame(frame)# Return to main contentdriver.switch_to.default_content()

Multiple Windows

python
original_window = driver.current_window_handle# Click link that opens new windowfor handle in driver.window_handles:    if handle != original_window:        driver.switch_to.window(handle)        break# Return to originaldriver.switch_to.window(original_window)

Performance and Reliability

  • Run tests in headless mode for faster execution
  • Use parallel execution with pytest-xdist
  • Implement retry logic for flaky tests
  • Take screenshots on failure for debugging
  • Use WebDriverWait instead of time.sleep()

Key Dependencies

  • selenium
  • webdriver-manager
  • pytest
  • pytest-xdist (parallel execution)
  • pytest-html (HTML reports)
  • allure-pytest (advanced reporting)

Configuration

python
# pytest.ini[pytest]addopts = -v --html=reports/report.htmlmarkers =    smoke: Quick smoke tests    regression: Full regression tests

Debugging Tips

  • Enable browser developer tools in non-headless mode
  • Use driver.save_screenshot('debug.png') for visual debugging
  • Print page source: print(driver.page_source)
  • Use breakpoints with import pdb; pdb.set_trace()

來源與署名

來源：Mindrally/skills位於selenium-automation提交7682ca7

授權條款： 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

更多來自 Mindrally/skills 的技能

Zustand State Management

Mindrally

在 React 與 TypeScript 應用程式中設計與使用 Zustand 狀態管理的實務指南。

Software Development2695 週前更新

Zod Schema Validation

Mindrally

提供在應用程式中使用 Zod 進行結構描述驗證與 TypeScript 型別推斷的指引。

Software Development2695 週前更新

Woocommerce

Mindrally

針對 WordPress 與 WooCommerce 外掛開發的指引，涵蓋 PHP 規範、鉤子、安全性與擴充方式。

Software Development2695 週前更新

Wordpress

Mindrally

以 PHP 規範、安全實務與測試慣例指導 WordPress 與 WooCommerce 開發。

Software Development2695 週前更新

Websocket Development

Mindrally

提供使用 WebSocket 通訊建構安全、可擴充即時應用程式的最佳實務指引。

Software Development2695 週前更新

Web Development

Mindrally

提供 Bootstrap、Django、HTMX 及一般 Web 最佳實務的 Web 開發指引。

Software Development2695 週前更新

更多Software Development技能

Playground

anthropics

精選

建立自成一體的互動式 HTML 遊樂場，包含控制項、即時預覽與可複製的提示詞輸出。

Software Development37K今天更新

M5 Onboard

anthropics

精選

透過 USB 偵測 M5Stack ESP32 開發板，燒錄 UIFlow 2.0 韌體並安裝 MicroPython 應用程式套件。

Software Development37K今天更新

Cardputer Buddy

anthropics

精選

指導迭代 Cardputer-Adv 的 MicroPython 應用程式套件：新增應用程式、透過 USB 序列埠推送檔案、查看日誌並執行 REPL 指令。

Software Development37K今天更新

Web Design Guidelines

vercel-labs

精選

依據從遠端來源取得的 Web Interface Guidelines 審查 UI 程式碼，並以 file:line 形式回報問題。

Software Development32K5 週前更新

Vercel React Native Skills

vercel-labs

精選

React Native 與 Expo 最佳實務規則，涵蓋清單效能、動畫、導覽、UI 模式、狀態與 monorepo 設定。

Software Development32K5 週前更新

Vercel React Best Practices

vercel-labs

精選

Vercel 的 React 與 Next.js 效能指南，以 70 條規則的形式用於撰寫、審查與重構程式碼。

Software Development32K5 週前更新