sindresorhus/pageres
Pageres
Pageres is an automated web page capturer and command line interface that renders HTML content and websites into images. It uses a headless Chromium browser to generate screenshots of full pages or specific elements across multiple screen resolutions.
The tool allows for the simulation of different device dimensions to verify responsive design and the creation of visual snapshots for UI regression testing. It supports the capture of protected pages by passing custom HTTP headers, cookies, and basic authentication credentials.
The system includes capabilities for page content manipulation through custom CSS and JavaScript injection, as well as the ability to isolate specific DOM elements using CSS selectors. It further provides environment emulation for dark mode preferences and asynchronous interaction automation to reach specific page states before capture.
Features
- Headless Export Tools - Provides a command line utility to render web pages and HTML content into static image files via browser automation.
- Screenshot Generators - Generates high-quality images of web pages, HTML strings, or data URIs across multiple resolutions.
- Web Page Screenshot and PDF Tools - Renders HTML content and web pages into images using headless Chromium and browser emulation.
- Responsive Testing Tools - Generates automated screenshots across multiple screen resolutions to verify how layouts appear on different device dimensions.
- Responsive Design - Captures website screenshots across multiple screen resolutions to verify responsive layouts.
- Headless Browsers - Uses a headless Chromium browser instance to render web pages and execute JavaScript before capture.
- Viewport Emulators - Simulates various screen resolutions by programmatically resizing the browser window.
- Browser Automation - Controls a Chromium browser via Puppeteer to automate page navigation and element interaction.
- Full Page Screenshots - Provides a command line interface for creating high-quality screenshots of web elements and full pages.
- Interaction Automation - Executes clicks and asynchronous functions to reach a specific page state before imaging.
- Region Capture - Captures specific rectangular regions of a page via CSS selectors or by hiding unwanted items.
- Automated Visual Documentation - Generates consistent images of web pages or UI elements for technical manuals or portfolios.
- Authenticated Page Capture - Takes screenshots of websites that require custom HTTP headers, cookies, or authentication credentials.
- Browser Environment Emulators - Simulates user conditions by setting dark mode preferences and adding asynchronous page load delays.
- Visual Regression Testing - Creates visual snapshots of page states and elements to detect unintended appearance or layout changes.
- Cosmetic Page Modifiers - Applies custom CSS or executes JavaScript to modify target page appearance and behavior.
- Script Injections - Injects and executes arbitrary JavaScript and CSS within the browser context to modify page state.
- Coordinate-Based Isolation - Allows targeting specific DOM elements for capture by querying precise bounding box coordinates.
- Automation & RPA - Webpage screenshot utility.
- Project Documentation Examples - Features common use case examples.
