v3.0.0-rc2

Note

Prebuilds are currently only available for Linux (x64, glibc), macOS (x64) and Windows (x64). Please give this version a try and let us know if you run into issues!

npm install canvas@next

---

This release notably changes to using N-API. 🎉

Breaking

• Dropped support for Node.js 16.x and below.

Changed

• Migrated to N-API (by way of node-addon-api) and removed libuv and v8 dependencies
• Change from node-pre-gyp to prebuild-install
• Defer the initialization of the op variable to the default switch case to avoid a compiler warning. (#2229)
• Use a default switch case with a null statement if some enum values aren't suppsed to be handled, this avoids a compiler warning. (#2229)
• Migrate from librsvg's deprecated rsvg_handle_get_dimensions() and rsvg_handle_render_cairo() functions to the new rsvg_handle_get_intrinsic_size_in_pixels() and rsvg_handle_render_document() respectively. (#2229)
• Avoid calling virtual methods in constructors/destructors to avoid bypassing virtual dispatch. (#2229)
• Remove unused private field backend in the Backend class. (#2229)
• Add Node.js v20 to CI. (#2237)
• Replaced dtslint with tsd (#2313)

Added

• Added string tags to support class detection

Fixed

• Fix a case of use-after-free. (#2229)
• Fix usage of garbage value by filling the allocated memory entirely with zeros if it's not modified. (#2229)
• Fix a potential memory leak. (#2229)
• Fix the wrong type of setTransform

v2.11.2

Note: this is the first version with prebuilds for Node.js v20.

Fixed

• Building on Windows in CI (and maybe other Windows configurations?) (#2216)

v2.11.1

Fixed

• Add missing property canvas to the CanvasRenderingContext2D type
• Fixed glyph positions getting rounded, resulting text having a slight letter-spacing effect
• Fixed ctx.font not being restored correctly after ctx.restore() (#1946)

v2.11.0

Fixed

• Replace triple-slash directive in types with own types to avoid polluting TS modules with globals (#1656)

v2.10.2

Fixed

• Fix Assertion failed: (object->InternalFieldCount() > 0), function Unwrap, file nan_object_wrap.h, line 32. (#2025)
• textBaseline and textAlign were not saved/restored by save()/restore(). (#1936)
• Update nan to v2.17.0 to ensure Node.js v18+ support.

Changed

• Improve performance and memory usage of save()/restore().
• save()/restore() no longer have a maximum depth (previously 64 states).

v2.10.1

Fixed

• Fix actualBoundingBoxLeft and actualBoundingBoxRight when textAlign='center' or 'right' (#1909)
• Fix rgba(r,g,b,0) with alpha to 0 should parse as transparent, not opaque. (#2110)

v2.10.0

Added

• Export pangoVersion
• ctx.roundRect()

Fixed

• rgba(r,g,b) with no alpha should parse as opaque, not transparent. (#2029)
• Typo in PngConfig.filters types. (#2072)
• createPattern() always used "repeat" mode; now supports "repeat-x" and "repeat-y". (#2066)
• Crashes and hangs when using non-finite values in context.arc(). (#2055)
• Incorrect context.arc() geometry logic for full ellipses. (#1808, (#1736))
• Added missing deregisterAllFonts to the Typescript declaration file (#2096)
• Add User-Agent header when requesting remote images (#2099)

v2.9.3

Fixed

• Wrong fonts used when calling registerFont multiple times with the same family name (#2041)

v2.9.2

Fixed

• All exports now work when Canvas is used in ES Modules (ESM). (#2047)
• npm rebuild will now re-fetch prebuilt binaries to avoid NODE_MODULE_VERSION mismatch errors. (#1982)

v2.9.1

Fixed

• Stringify CanvasGradient, CanvasPattern and ImageData like browsers do. (#1639, #1646)
• Add missing include for toupper.
• Throw an error instead of crashing the process if getImageData or putImageData is called on a PDF or SVG canvas (#1853)
• Compatibility with Typescript 4.6
• Near-perfect font matching on Linux (#1572)
• Fix multi-byte font path support on Windows.