microsoft/playwright-python
Playwright Python
Playwright for Python is a browser automation framework designed for end-to-end testing, web scraping, and user interaction simulation. It functions as a headless browser controller that enables programmatic navigation, data extraction, and the execution of complex workflows across multiple rendering engines.
The framework distinguishes itself through an actionability-aware interaction engine that automatically verifies element readiness before performing actions, significantly reducing test flakiness. It utilizes isolated browser contexts to maintain separate storage and cookies for parallel execution, while its network interception capabilities allow for real-time traffic modification, mocking, and API-level validation.
The platform provides a comprehensive suite of tools for managing browser lifecycles, including device emulation, geolocation overrides, and the ability to manipulate browser time. It supports advanced debugging through execution traces, visual session recording, and breakpoint inspection, ensuring visibility into automated processes.
The project is distributed as a Python library and includes built-in support for containerized environments and remote browser connections.
Features
- End-to-End Testing - Verifies complete user workflows by orchestrating browser actions, network traffic interception, and state validation.
- Browser Automation Frameworks - Provides programmatic control over web browsers to automate user interactions, testing, and data extraction.
- Web Scraping - Provides programmatic navigation and data extraction capabilities for web scraping and automated testing.
- Browser Automation - Controls web browsers programmatically to perform repetitive tasks, extract data, or simulate complex user behavior.
- Headless Browser Controllers - Manages headless or headed browser instances to execute automated tasks, visual regression testing, and performance monitoring.
- Trace Inspection Tools - Records full-fidelity execution traces, including network activity and DOM snapshots, for debugging failed test runs.
- Test Trace Viewers - Visualizes recorded test sessions by replaying actions and inspecting diagnostic data for every step.
- API and Network Testing - Validates backend services and simulates network conditions by intercepting, mocking, or modifying HTTP and WebSocket traffic.
- Element Interaction - Provides high-level APIs for simulating user input on web elements with automatic readiness checks.
- Browser Context Isolation - Creates ephemeral, independent browser sessions that maintain separate storage and cookies for parallel execution.
- Network and API Mocking - Intercepts network traffic to return custom payloads, ensuring tests remain fast and independent of live backend services.
- Actionability Verification - Automatically verifies element visibility, stability, and readiness before performing actions to prevent flaky test failures.
- Cross-Browser Testing Tools - Ensures web applications render and behave consistently by running automated test suites across multiple browser engines.
- Page Object Models - Encapsulates page elements and actions into reusable objects to improve test maintainability.
- Semantic Locators - The framework locates web elements using semantic properties like roles or labels to ensure that automation remains resilient to structural changes and reflects real user interactions.
- Browser Navigation - Directs browsers to specific web addresses and manages page load events for automated interaction.
- Network Interception Tools - Hooks into the browser network stack to intercept, block, or modify HTTP and WebSocket traffic for mocking and simulation.
- Network Request Interceptors - Blocks outgoing network requests to isolate frontend components from backend dependencies during test execution.
- Automated Login Frameworks - Performs login sequences through browser interactions to establish authenticated session states for automated testing.
- Traffic Interception and Modification - Captures and modifies network traffic in real-time to simulate various network conditions during browser automation.
- Browser Environment Emulators - Simulates diverse device profiles, viewports, and network conditions for cross-environment testing.
- Auto-Waiting Assertions - Repeatedly polls application state until conditions are met to handle dynamic content updates during testing.
- API Response Modifiers - Intercepts and modifies API responses in real-time to simulate backend edge cases during automated testing.
- Network Traffic Monitors - Tracks real-time network activity and WebSocket frame exchanges for debugging and state verification.
- Test Execution Runners - Manages the parallel execution of test suites across multiple processes to optimize runtime.
- Locator Chaining - The framework refines element selection by chaining multiple conditions together to target specific elements accurately even when the user interface changes dynamically during test execution.
- JavaScript Execution Bridges - Executes custom JavaScript within the browser context and serializes results back to the automation environment.
- Browser Session Persistence - Persists and restores cookies, local storage, and tokens across browser contexts to bypass repetitive login steps.
- Language Bindings - Official Python port of the automation framework.
- Multi Browser Drivers - Python library for cross-browser automation with a single API.
- Frameworks de pruebas - Automates browser interactions for end-to-end testing.
- Testing Tools - Listed in the “Testing Tools” section of the Awesome Python awesome list.
- Web Scraping - Browser automation library for Python.
- Pointer Interaction Primitives - Performs pointer-based actions like clicks and drag-and-drop while ensuring elements are actionable.
- Traffic Routing Proxies - Configures browser sessions to route network traffic through proxy servers with authentication support.
- Network Traffic Replay Tools - Simulates network interactions by replaying recorded request and response archives during automated test runs.
- WebSocket Message Interception - Monitors and manipulates real-time WebSocket messages to test bidirectional communication flows.
- Session Authentication - Extracts and applies authentication state between browser sessions and API contexts to maintain user sessions.
- Parallel Processing Utilities - Distributes test suites across multiple worker processes to maximize CPU utilization and reduce total execution time.
- Screenshot Capture - Captures visual screenshots of web pages or elements for documentation and visual regression testing.
- Time Manipulation - Overrides native browser time functions to enable deterministic testing of time-dependent features.
- Form Interaction Utilities - Automates data entry into form fields by focusing elements and triggering standard input events.
- Fixture Injection - Provides pre-configured browser, context, and page objects as test arguments to manage lifecycles automatically.
- Automation Selectors - Finds elements using CSS or XPath expressions when semantic properties are unavailable.
- Keyboard Input Simulations - Simulates precise keyboard sequences and shortcuts for testing input handling requirements.
- Browser Binary Managers - Manages the download, installation, and removal of browser engine binaries for automated environments.
- Browser Session Recorders - Records video of browser interactions during automated test sessions for post-mortem analysis.
- WebSockets - Communicates with browser engines via persistent WebSocket connections to execute commands and receive events in real-time.
- Automation Visualizers - Visualizes browser actions in real-time or slows down execution speed to inspect and troubleshoot complex interaction flows.
- Asynchronous Execution - Runs automation tasks using non-blocking code patterns to integrate with event-driven application architectures.
- Accessibility Snapshot Testing - Captures accessibility trees as YAML snapshots to verify application accessibility standards in automated tests.
- Network Resilience Simulators - Toggles browser offline status and network conditions to verify application resilience and fallback behavior.
- Multi-Window Controllers - Manages multiple concurrent browser windows, tabs, and popups during automated sessions.
- Driver Protocols - Uses a unified wire protocol to bridge high-level automation commands to multiple browser-specific implementations.
- Capture Utilities - Captures file downloads triggered by web pages, providing access to source URLs and data streams.
- Uniqueness Enforcement - The framework throws an error when multiple elements match a single selector to prevent ambiguous interactions and ensure that every test step targets exactly one specific element.
- HTTP Request Interceptors - Handles HTTP authentication challenges by injecting credentials during the request lifecycle.
- Browser Dialog Handlers - Intercepts and programmatically handles native browser alerts, confirmations, and prompts during automated interactions.
- Browser Permission Management - Manages browser-level permissions like geolocation and notifications for specific domains during automated sessions.
- Geolocation Emulation Tools - Overrides browser geolocation coordinates to verify location-aware web features.
- File Upload Utilities - Automates the selection and uploading of files into web input elements during browser sessions.
- Frame Interactions - Identifies and performs automated actions within nested iframe structures on a web page.
- Remote Browser Connections - Executes browser automation tasks on a remote server or container while keeping the test logic running locally.
- Debugging and Inspection Tools - Pauses test execution at specific lines to allow interactive inspection of the browser state and application variables.
- Containerized Execution - Runs browser automation scripts within isolated container environments by providing pre-configured images.
- Desktop Application Automation - Connects to desktop applications using browser control protocols to perform automation within embedded web views.
- Headed Execution Modes - Allows launching browsers with a visible interface to facilitate manual observation of automated workflows.
- Custom Selector Engines - Registers custom logic for locating elements on a page to support complex or non-standard DOM structures.
- HTTP Request Clients - Provides programmatic HTTP request execution for validating backend endpoints and performing data operations during test workflows.
- Regional Configuration Utilities - Adjusts browser language and timezone settings to verify application behavior across global regions.
- Focus Management - Provides programmatic control over element focus to trigger dynamic application behaviors during automated testing.
- Index-Based Selectors - The framework targets individual elements within a collection by their index or position to interact with the first, last, or any specific occurrence within a list.
- Touch Gesture Recognition Libraries - Simulates mobile-style touch gestures like swipes, pinches, and taps on web elements.
- Browser Extensions - Integrates local browser extensions into automated sessions by configuring browser contexts to load extension files.
- Browser Scripting Tools - Runs arbitrary scripts within the browser context to perform complex inspections or manual manipulations.
