# What changed in html2canvas-pro

> 96 changes in html2canvas-pro 1 to 2 from its official release notes, upgrade guides and advisories: 2 breaking, 13 new APIs and options. Each one cited. Sources checked 2026-10-18. HTML: https://unstale.sh/npm/html2canvas-pro/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## html2canvas-pro 2

### Breaking changes

- Rendering now composites full standard filter chains. (2.5.2) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.2)
- Enhances object-fit calculations, which can affect rendered output. (2.1.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.1.0)

### New APIs and options

- Adds device-pixel text-clip surfaces with stroke and shadow support. (2.5.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.1)
- Adds support for conic gradients. (2.5.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.0)
- Adds support for mask-image. (2.5.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.0)
- Adds support for repeating radial gradients. (2.5.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.0)
- Adds a white-space property descriptor, allowing the property to affect rendering. (2.3.8) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.3.8)
- Adds a skipCache flag for image descriptors so side effects run on every render and caching behavior is handled properly. (2.2.3) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.2.3)
- Adds CSS property descriptors and rendering support. (2.2.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.2.0)
- Adds an onError callback to Options and ContextOptions, wired to resource load failures. (2.2.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.2.0)
- Adds an onProgress callback. (2.2.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.2.0)
- Adds support for the mix-blend-mode CSS property when rendering. (2.1.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.1.0)
- Adds support for controlling image smoothing. (2.0.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.0.1)

### Performance

- Uses native layer filters with a verified SVG fallback. (2.4.4) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.4.4)
- Adds CSS parse cache LRU eviction and background pattern caching. (2.2.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.2.0)
- Adds an LRU pattern cache for linear-gradient backgrounds. (2.2.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.2.0)
- Defers CSS parsing as part of performance improvements. (2.1.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.1.0)
- Skips pseudo-element getComputedStyle calls for void and replaced elements. (2.1.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.1.0)

### Behavior and default changes

- Adds support for rendering repeating conic gradients. (2.5.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.1)
- Adds support for backdrop-filter. (2.5.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.0)
- Adds support for background-clip: text using TextClipRenderer. (2.5.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.0)
- Adds support for border-image outset. (2.5.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.0)
- Adds support for box-reflect. (2.5.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.0)
- Adds support for image-set. (2.5.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.0)
- Adds support for text-emphasis. (2.5.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.0)
- Enables CORS loading for cross-origin images in the Cache class. (2.3.8) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.3.8)
- Implements text wrapping for textareas. (2.3.8) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.3.8)
- Custom element clones now preserve shadow roots and attributes. (2.3.6) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.3.6)
- Improves node parsing logic, which may affect how content is handled. (2.3.5) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.3.5)
- Adds support for rendering text with background-clip: text. (2.3.3) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.3.3)
- Length-percentage handling is enhanced, which may affect how rendered content using these values is handled. (2.3.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.3.0)
- Implements comprehensive drop-shadow parsing in FilterEffect. (2.2.4) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.2.4)
- Text rendering and parsing now support writing modes. (2.0.4) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.0.4)

### Fixes and other changes

- Border rendering is corrected. (2.5.2) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.2)
- Decoration colour rendering is corrected. (2.5.2) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.2)
- The hsl() colour parser is repaired. (2.5.2) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.2)
- The scale-down object-fit rendering is corrected. (2.5.2) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.2)
- Outer SVG transforms are normalized like HTML container transforms. (2.5.2) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.2)
- Rendering fixes radial gradients. (2.5.2) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.2)
- Uses the browser's default accent blue for auto accent-color and input accent rendering. (2.5.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.1)
- Appends ::after pseudo content after an element's children. (2.5.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.1)
- Scales canvas shadow and filter metrics to device space. (2.5.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.1)
- Clamps quote depth when close-quotes are unbalanced. (2.5.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.1)
- Corrects rendering of isolated blend groups. (2.5.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.1)
- Draws list markers as geometric shapes. (2.5.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.1)
- Skips unsupported image functions in list-style-image. (2.5.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.1)
- Contains list-style images within the 1em marker box. (2.5.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.1)
- Corrects coordinate math when rendering mask, repeating and radial gradients. (2.5.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.1)
- Keeps the surface-root overflow clip inside composited surfaces. (2.5.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.1)
- Applies -webkit-line-clamp to flow-root containers. (2.5.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.1)
- Corrects the coordinate space used for zoom. (2.5.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.1)
- Fixes rendering background-clip: text when text has multiple fragments. (2.5.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.0)
- Adds support for border-image width. (2.5.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.5.0)
- Corrected box-shadow scaling, clipping, and inset rendering. (2.4.5) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.4.5)
- Box shadows are preserved through effective canvas transforms. (2.4.5) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.4.5)
- CSS transforms are kept when getTransform is unavailable. (2.4.5) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.4.5)
- Box shadows are rasterized within bounded filter surfaces. (2.4.4) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.4.4)
- CJK text with letter-spacing stays on the alphabetic baseline. (2.4.4) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.4.4)
- Supported filters and opacity are composited on layer surfaces. (2.4.4) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.4.4)
- Shadow mask displacement is bounded inside filter surfaces. (2.4.4) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.4.4)
- Preserves quoted font family names during serialization. (2.4.3) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.4.3)
- Removes horizontal seams on radial gradients whose vertical radius exceeds the horizontal one. (2.4.2) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.4.2)
- Prevents SVG offsets from being serialized. (2.4.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.4.1)
- Preserves constrained input text during canvas rendering. (2.4.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.4.0)
- Restores scroll after onclone runs. (2.4.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.4.0)
- Adjusts mask rectangle anchoring to prevent inverted inset box-shadow rendering. (2.3.9) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.3.9)
- Fieldset bounds are adjusted to center the legend vertically in ElementContainer. (2.3.7) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.3.7)
- Fieldset border rendering now handles legend bounds. (2.3.6) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.3.6)
- Adds handling for whitespace-only computed CSS values. (2.3.4) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.3.4)
- Fixes webfont text baseline shifts that pushed labels out of their box. (2.3.2) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.3.2)
- Renders drop-shadow() via ctx.shadow instead of stripping it. (2.2.2) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.2.2)
- Strip drop-shadow() from ctx.filter to avoid canvas taint. (2.2.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.2.1)
- Forward maxCacheSize to Cache so the configured cache limit is applied. (2.2.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.2.1)
- Extends the scroll position fallback to desktop Safari. (2.1.0) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.1.0)
- Range offsets remain aligned after a transform. (2.0.4) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.0.4)
- Corrects the order of adoptNode() during document cloning. (2.0.3) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.0.3)
- Resolves background images using the source document's baseURI. (2.0.3) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.0.3)
- Fixes the baseline offset for CJK text. (2.0.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.0.1)
- Adds support for the clip-path CSS property with various shape functions. (2.0.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.0.1)
- Fixes letter-spacing rendering. (2.0.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.0.1)
- Replaces transforms with identity values during DOM normalization. (2.0.1) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v2.0.1)

## html2canvas-pro 1

### New APIs and options

- Adds iframeContainer; the notes do not specify further details. (1.6.5) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v1.6.5)
- Supports calc() in background-position values. (1.6.2) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v1.6.2)

### Behavior and default changes

- Enhances text decoration support. (1.6.5) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v1.6.5)
- Adds support for text-overflow: ellipsis. (1.6.5) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v1.6.5)

### Fixes and other changes

- Fixed previews breaking after the first shadow-root. (1.6.7) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v1.6.7)
- Fixes lack of support for line-clamp. (1.6.6) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v1.6.6)
- Adds support for rotate. (1.6.5) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v1.6.5)
- Fixes lack of support for radial gradients. (1.6.3) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v1.6.3)
- Fixes rendering text inside an inline-flex container when the text is its only child. (1.6.2) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v1.6.2)
- Fixes oklch colors sometimes being downgraded to default black when used with Tailwind. (1.6.2) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v1.6.2)
- Fixes incorrect rendering of placeholder padding. (1.6.2) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v1.6.2)
- Fixes rendering content inside <slot>. (1.6.2) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v1.6.2)
- Fixes text rendering lower than in the browser. (1.6.2) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v1.6.2)
- Fixes webkit-text-stroke being offset below when paint-order is stroke fill. (1.6.2) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v1.6.2)
- Fixes handling of custom properties in Chrome 138 by ignoring them. (1.5.13) — [release notes](https://github.com/yorickshan/html2canvas-pro/releases/tag/v1.5.13)