Upgrading sass-loader 16 to 17
Breaking16.0.8 → 17.1.0Breaking4Platform1New2Fixed1
BreakingUpgrade verdict
4 breaking changes and a platform requirement change.
In plain terms
- The loader now picks the fastest Sass mode automatically by default, which should make builds faster.
- Projects that use node-sass must switch to the Dart Sass implementation.
- The package is now written as ES modules but still works with both require and import.
- The old Sass JavaScript API is no longer supported; only the modern API is used.
Must act Top 4 of 5 that need code or config changes
Node.js requirement changed in 17.0.0: >= 18.12.0 → >= 22.11.0.
Drops neo-async.
Installs 0 packages in all (was 1).
What you must change
Breaking4
Adds "auto" to the api option and makes it the default, enabling the modern compiler with a shared long-running compiler when supported.
apiRemoves node-sass support.
node-sassConverts source to native ECMAScript modules, declaring "type": "module" and exposing ESM and CommonJS builds via the exports field.
exportsRemoves legacy Sass JS API support.
Platform1
Raises the minimum supported NodeJS version to 22.11.0.