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周前更新