chromedp/chromedp
Chromedp
chromedp is a browser automation framework and driver that controls web browsers via the Chrome DevTools Protocol. It functions as a headless browser automation tool and web browser controller, enabling the programmatic management of browser sessions, targets, and network responses through a remote debugging interface.
The project provides specialized capabilities for Chrome DevTools Protocol automation, including headless browser testing, web scraping and data extraction, and mobile device emulation. It also supports browser-based visual regression by capturing precise screenshots of web pages or specific elements to detect layout changes.
The framework covers a broad surface of automation tasks, including JavaScript execution, DOM tree manipulation, and user interaction simulation such as mouse events and dialog handling. It also includes utilities for network navigation, page metadata retrieval, and environment emulation through device profiles and viewport simulation.
Features
- Browser Automation Frameworks - Provides a comprehensive framework for executing JavaScript, manipulating the DOM, and simulating user events in a web browser.
- Remote Browser Controllers - Provides the primary driver for controlling web browsers via the Chrome DevTools Protocol for headless automation.
- Chrome DevTools Protocols - Controls web browsers programmatically by transferring JSON messages over WebSockets via the Chrome DevTools Protocol.
- Headless Browser Automation - Provides programmatic control over headless browser engines for navigation, data extraction, and interaction.
- JSON-RPC Interfaces - Implements a typed communication channel using JSON-RPC to serialize requests and responses between the driver and browser.
- Message Encoders and Decoders - Handles the encoding and decoding of JSON messages to ensure reliable communication between the driver and the browser.
- Element Interaction - Simulates user interactions such as clicking elements identified by CSS or XPath selectors.
- Headless Browser Controllers - Provides a runtime environment for managing the lifecycle and execution of headless browser instances.
- JavaScript Execution Bridges - Executes arbitrary JavaScript code within the browser and captures results as typed values or remote objects.
- Browser Session Management - Tracks specific browser tabs, frames, and execution contexts to route commands to the correct page instance.
- Navigation Controllers - Implements high-level navigation to load specific URLs and synchronize with page content loading.
- Browser Lifecycle Managers - Controls the lifecycle and state of specific browser targets, including the tracking of frames and execution contexts.
- Headless Browser Orchestrators - Manages the complete lifecycle of headless browser binaries, including custom launch parameters and process termination.
- Remote Browser Connections - Provides the mechanism to establish WebSocket connections to browser instances for remote automation control.
- Automatic Page Metadata Extraction - Extracts metadata such as page titles and current URLs from active browser tabs.
- Remote Object Mappings - Tracks browser-side JavaScript objects using unique identifiers to manipulate values without transferring the full object state.
- Web Data Extraction - Enables programmatic navigation and JavaScript execution to extract structured data from the DOM.
- Mouse Automation - Programmatically simulates mouse movements and events at precise coordinates or target elements.
- HTTP Response Processors - Allows capturing and processing of HTTP responses following specific browser actions to retrieve status and body content.
- Browser Function Invocations - Provides the ability to call specific JavaScript functions within the browser and convert return values into local variables.
- Screenshot Capture - Captures visual images of specific DOM elements by calculating their bounding boxes.
- Viewport and User Agent Simulation - Provides utilities to emulate device profiles, viewport dimensions, and user agent strings for responsive layout testing.
- Asynchronous Polling Mechanisms - Provides mechanisms to repeatedly evaluate browser-side expressions until a specific condition is met for asynchronous synchronization.
- Input Simulations - The ability to trigger click events at specific coordinates or on DOM nodes using modifier keys.
- Visual Regression Testing - Detects visual changes and layout regressions by capturing and comparing snapshots of pages or elements.
- Predicate Waiting - Implements a mechanism that pauses execution until a JavaScript expression returns a truthy value via polling or mutation triggers.
- Target Detection - Includes a monitoring system that detects new tabs or windows and returns their unique identifiers.
- DOM Manipulation - Modifies the live document structure by inserting, removing, or replacing DOM elements.
- Page Load State Tracking - Provides mechanisms to trigger page reloads or stop the loading process to control active navigation.
- Browser Dialog Handlers - Programmatically intercepts and responds to browser-native alerts, confirmation prompts, and input dialogs.
- Browser Configuration Profiles - Allows setting precise launch parameters for the browser process, such as GPU usage and custom user data directories.
- Viewport Emulators - Sets the viewport and user agent to match specific hardware models for responsive layout testing.
- Automation Libraries - Go-based library for driving browser tasks.
- Desktop and GUI Development - Chrome DevTools Protocol driver.
