zumerlab/snapdom
Snapdom
Snapdom is a DOM capture engine that serializes live web page elements into images, videos, documents, and other formats. It converts any DOM subtree into PNG, JPG, WebP, SVG, PDF, or self-contained HTML, and can record animating elements as video files or animated GIFs using the browser's MediaRecorder API.
The library distinguishes itself through a plugin-based architecture that allows custom output format handlers and pipeline hooks to extend the capture process without re-cloning the source element. It manages separate caches for images, styles, and fonts with preloading and clearing methods to optimize memory and rendering speed, and resolves cross-origin assets through a configurable proxy to avoid canvas taint. Snapdom also supports visual regression testing by comparing captured subtrees against saved baselines, and can generate annotated screenshots with bounding boxes for use with large language models.
Additional capabilities include CSS effect rendering for transforms, shadows, clip-paths, blend modes, masks, and pseudo-elements, as well as font embedding to preserve original typography. The capture pipeline supports dimension and scale control, node filtering, form value capture, text find-and-replace, and timestamp overlays, with a reusable composable hook pattern for declarative use in component frameworks.
Features
- DOM Subtree Capture and Exports - Captures any DOM subtree as a self-contained representation and exports it to multiple formats.
- DOM Subtree Animated Recordings - Records animating DOM elements as video files or animated GIFs using browser capture APIs.
- DOM-to-Image Converters - Converts any DOM element into PNG, JPG, WebP, SVG, or PDF formats.
- Raster Image Exports - Renders DOM subtrees to PNG, JPG, or WebP bitmap formats for download or further use.
- Multi-Format Image Exports - Converts captured DOM representations into PNG, JPG, WebP, SVG, Canvas, or Blob output.
- DOM Export Plugins - Ships a plugin system for adding custom output formats and pipeline hooks to the DOM capture process.
- DOM Element PNG Captures - Captures any DOM subtree as a PNG image by attaching a ref and calling a single function.
- DOM Subtree Renderers - Clones and serializes a live DOM subtree with styles, images, and fonts for self-contained export.
- DOM Subtree Capture Engines - Captures, modifies, and exports DOM subtrees as images, videos, or documents.
- DOM-to-Canvas Renderers - Provides a DOM-to-canvas rendering pipeline that serializes live DOM subtrees into canvas representations.
- Screenshot Generators - Generates high-fidelity screenshots of DOM elements with embedded styles and fonts.
- Captured Element Downloads - Triggers a browser download of the captured element as an image file in a chosen format.
- Multi-Format Exports - Routes a single cloned DOM subtree through multiple output converters without re-cloning the source element.
- Single-Capture - Clones the DOM element once and exports it to multiple formats without re-cloning the source.
- DOM Subtree JPG Exports - Exports DOM subtrees as JPEG images for compressed raster output.
- Font Inlining - Inlines font-face rules and icon fonts into captured output to preserve original typography.
- DOM Subtree - Captures animating DOM elements frame by frame and encodes them into animated GIFs.
- Animation Frame Capturers - Captures frame-by-frame changes of animating DOM elements and encodes them into animated GIFs or video files.
- Captured Image Downloads - Downloads the captured image directly as a file with a specified format and filename.
- DOM Subtree SVG Captures - Converts DOM subtrees into SVG documents preserving layout, styles, and fonts.
- DOM Subtree SVG Exports - Exports DOM subtrees as SVG for scalable vector output.
- DOM Subtree Video Recordings - Captures animating DOM elements to video via the native MediaRecorder API.
- Export Pipeline Plugins - Provides a plugin system for registering custom output format handlers and pipeline hooks in the capture process.
- Pipeline Plugins - Registers custom hooks that run at each stage of the capture and export process.
- Capture - Extends the capture and export process with custom hooks and output format plugins.
- Composable Capture Hooks - Ships a reusable composable hook that wraps the DOM capture lifecycle for declarative use in component frameworks.
- Capture Format Plugins - Defines new output methods that become available on the capture result object via a plugin system.
- Visual Regression Testing - Compares captured DOM subtrees against saved baselines to detect visual differences in web interfaces.
- Computed Style Renderers - Renders CSS transforms, shadows, clip-paths, blend modes, masks, and pseudo-elements into captured output.
- CSS Effect Renderers - Renders CSS transforms, shadows, clip-paths, blend modes, masks, and pseudo-elements into captured output.
- DOM Subtree Blob Captures - Converts a selected DOM element into a Blob object for uploading or further processing.
- PNG Captures - Converts DOM elements into PNG images with optional retina resolution support.
- Web-Compatible Font Embedding - Downloads and inlines web fonts into captured output to preserve original typography.
- DOM Node Filtering - Excludes specific DOM elements from capture using CSS selectors or custom filter functions.
- DOM Video Frame Captures - Draws the current frame of a video element so it can be captured like any other DOM node.
- DOM Subtree Video Recordings - Records animating DOM subtrees as video files or animated GIFs using the MediaRecorder API.
- JavaScript 框架汇总 - Listed in the “JavaScript 项目” section of the Great Open Source Project awesome list.
