hardkoded/puppeteer-sharp
Puppeteer Sharp
Puppeteer Sharp is a .NET wrapper and automation library used to programmatically drive headless Chrome and Chromium browsers. It functions as a Chrome DevTools Protocol client, providing a framework for web scraping and the automation of web page interactions.
The project enables the execution of JavaScript within the browser context and supports attaching to remote browser sessions via WebSocket endpoints. It allows for the manipulation of browser states to perform functional web testing and visual regression analysis.
Capability areas include content transformation via HTML injection, page screenshot capture, and the generation of PDF documents. The library also provides synchronization tools to wait for specific CSS selectors or JavaScript conditions before proceeding with execution.
Features
- Web Automation and Scraping - Provides a full infrastructure for programmatic browser control, data extraction, and automated web interaction.
- Browser-Context Script Executions - Enables the execution of JavaScript expressions and functions within the browser's global or element-bound context.
- JSON-RPC Interfaces - Maps .NET method calls to JSON-RPC messages for communication with the browser's internal debugging interface.
- Remote Debugging Protocols - Utilizes the Chrome DevTools Protocol to programmatically inspect and manipulate the DOM without a GUI.
- Web Testing Frameworks - Provides a framework for running functional tests by simulating user interactions in a browser.
- JavaScript Execution Bridges - Provides a mechanism to execute JavaScript within the browser context and serialize results back to .NET.
- Headless Browser Automation Libraries - Acts as a programmatic interface for driving headless Chrome browsers to perform scraping and testing.
- Remote Browser Controllers - Manages and interacts with Chrome browser instances hosted on remote servers via standardized messaging.
- DevTools Protocol Clients - Implements a client that communicates with browsers through the Chrome DevTools Protocol to control behavior.
- Remote Browser Connections - Supports attaching to existing browser instances via WebSocket endpoints to control remote sessions.
- Browser Automation Wrappers - Provides a .NET API wrapper for controlling headless Chrome and Chromium browsers.
- Web Scraping Frameworks - Provides a comprehensive framework for extracting structured data from dynamic websites via headless browser automation.
- Browser Automation WebSocket Bridges - Uses WebSocket connections to bridge the .NET automation framework to remote browser instances.
- Web-to-PDF Converters - Renders web pages and HTML content into static PDF documents using a headless browser.
- Dynamic PDF Generators - Converts dynamic HTML content and web pages into PDF documents for reporting or archiving.
- Automation Wait Conditions - Provides tools to pause execution until specific CSS selectors or JavaScript conditions are met for stable automation.
- CDP Screenshot Captures - Captures page screenshots at specified viewport sizes using the Chrome DevTools Protocol.
- Viewport Dimension Controls - Allows precise control of browser viewport dimensions to generate consistent screenshots and PDFs.
- Visual Regression Testing - Supports automated capture and comparison of screenshots to detect unintended UI changes.
- Automation Libraries - .NET port of the browser automation library.
- UI Automation - .NET port of the Puppeteer browser automation API.
