\n \n\n## Why html2canvas-pro?\n\nhtml2canvas-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:\n- Color functions `color()` (incl. relative colors), `lab()`, `lch()`, `oklab()`, `oklch()`\n- `background-clip: text` support\n- `mix-blend-mode` support\n- `object-fit` support for ``\n- CSS `clip-path` support (inset, circle, ellipse, polygon, path)\n- CSS `writing-mode` support (horizontal-tb, vertical-rl, vertical-lr)\n- Native `drop-shadow()` filter rendering via the canvas shadow API\n- **Image smoothing control** — CSS `image-rendering` property and `imageSmoothing`/`imageSmoothingQuality` options\n- **Security validation** — Built-in input validation (XSS/SSRF protection)\n- **Performance monitoring** — Built-in performance measurement API\n- **Progress & error callbacks** — `onProgress` / `onError` options and `AbortSignal` cancellation\n- **Performance optimizations** — deferred CSS parsing and LRU caches for gradients & CSS parsing\n- Various bug fixes from the [changelog](./CHANGELOG.md)\n\nIf you found this helpful, don't forget to\nleave a star 🌟.\n\n## Installation\n\n```sh\nnpm install html2canvas-pro\npnpm add html2canvas-pro\nyarn add html2canvas-pro\n```\n\n## Usage\n```javascript\nimport html2canvas from 'html2canvas-pro';\n```\n\nTo render an `element` with html2canvas-pro with some (optional) [options](/docs/configuration.md), simply call `html2canvas(element, options);`\n\n### Basic Example\n\n```javascript\nhtml2canvas(document.body).then(function(canvas) {\n document.body.appendChild(canvas);\n});\n```\n\n### Controlling Output Dimensions\n\n⚠️ **Important**: By default, the output canvas dimensions are affected by `devicePixelRatio`. \n\n```javascript\n// If you need exact pixel dimensions (e.g., for a specific file size):\nhtml2canvas(element, {\n width: 1920,\n height: 1080,\n scale: 1 // Set scale to 1 for exact dimensions\n}).then(canvas => {\n // Canvas will be exactly 1920×1080 pixels\n const dataURL = canvas.toDataURL('image/png');\n});\n```\n\nSee the [Configuration Guide](/docs/configuration.md#canvas-dimensions) for more details.\n\n## Contribution\n\nIf you'd like to add a feature, feel free to submit a PR.\n\nInterested in becoming a maintainer? Open an [issue](https://github.com/yorickshan/html2canvas-pro/issues) or reach out to [@yorickshan](https://github.com/yorickshan).\n\n## License\n\n[MIT](LICENSE)\n","readmeFilename":"README.md"}
![](\"https://raw.githubusercontent.com/yorickshan/html2canvas-pro/main/docs/public/logo.png\"){kind=logo}
\n![\"build](\"https://github.com/yorickshan/html2canvas-pro/actions/workflows/ci.yml/badge.svg?branch=main\"){kind=icon}
\n\t ![\"Ask](\"https://deepwiki.com/badge.svg\"){kind=icon}
\n