html2canvas-pro 2.5.1 → 2.5.3

package/README.md

@@ -27,7 +27,7 @@ Next generation JavaScript screenshot tool.
 html2canvas-pro is a fork of [niklasvh/html2canvas](https://github.com/niklasvh/html2canvas) that includes various fixes and new features. It offers several advantages over the original html2canvas:
 
 **Modern CSS support**
-- Color functions `color()` (incl. relative colors), `lab()`, `lch()`, `oklab()`, `oklch()`
+- Color functions `color()` (incl. relative colors), `lab()`, `lch()`, `oklab()`, `oklch()` — other functions resolve through the browser's computed styles
 - `background-clip: text` support
 - `mix-blend-mode` and `background-blend-mode` support
 - `object-fit` support for `<img/>`
@@ -38,7 +38,7 @@ html2canvas-pro is a fork of [niklasvh/html2canvas](https://github.com/niklasvh/
 - `conic-gradient()`, `repeating-conic-gradient()` and `repeating-radial-gradient()` — complete gradient family
 - `text-emphasis` (CJK emphasis marks), `-webkit-box-reflect`, `image-set()`, `border-image-outset` / `border-image-width`
 - `accent-color`, `outline`, `-webkit-text-fill-color`, `isolation`
-- `filter` compositing for eligible layers — `blur()` / `drop-shadow()` rendered on a dedicated surface with correct layer `opacity` (see [filter support notes](docs/filter-support.md))
+- `filter` chain compositing for eligible layers — the full standard filter function set rendered on a dedicated surface with correct layer `opacity` (see [filter support notes](docs/filter-support.md))
 - Faithful `box-shadow` rendering, including inset shadows, blur scaling, and shadows through transformed ancestors
 - `image-rendering` CSS property plus `imageSmoothing` / `imageSmoothingQuality` options for pixel-perfect output
 - Border image, counters & quotes, `direction`, `line-height`, `transform-origin`, and more — see the full [feature list](docs/features.md)
@@ -55,6 +55,16 @@ html2canvas-pro is a fork of [niklasvh/html2canvas](https://github.com/niklasvh/
 - LRU caches for CSS parsing and gradient patterns
 - Native canvas filter fast path with verified SVG fallback
 
+**Render speed** — html2canvas-pro(latest) vs html2canvas 1.4.1, headless Chromium on Apple M4, `scale: 1`, median of 10 interleaved runs ([benchmark script](scripts/benchmarks/render.bench.mjs), reproduce with `corepack pnpm bench:render`):
+
+| Fixture | html2canvas-pro | html2canvas 1.4.1 |
+| --- | --- | --- |
+| Simple document (~40 elements) | **80 ms** | 87 ms |
+| Large document (~1200 elements) | **295 ms** | 468 ms |
+| Modern-CSS page (`oklch()`, `conic-gradient()`, …) | **166 ms** | ✗ cannot render (throws on `oklch()`) |
+
+On element-heavy pages html2canvas-pro is ~1.6× faster, and it is the only one of the two that can render modern-CSS content at all. Absolute times vary by machine — compare ratios, not milliseconds.
+
 If you found this helpful, don't forget to
 leave a star 🌟.
 
@@ -177,7 +187,7 @@ The project uses [pnpm](https://pnpm.io) (the version is pinned via the `package
 corepack pnpm install
 corepack pnpm build          # tsc + Rolldown bundles (CJS/ESM/UMD)
 corepack pnpm unittest       # Vitest unit tests
-corepack pnpm test           # lint + unit tests + browser (Karma) tests
+corepack pnpm test           # lint + unit tests + browser reftests (Playwright)
 corepack pnpm docs:dev       # VitePress dev server
 corepack pnpm docs:api       # Generate the TypeDoc API reference
 ```