Skip to content

Upgrading sass-loader 8 to 9

Breaking8.0.2 → 9.0.3Breaking3Platform1New4Fixed8

Full comparisonBack to sass-loader
BreakingUpgrade verdict

3 breaking changes and a platform requirement change.

In plain terms
  • The loader now uses dart-sass instead of node-sass unless you configure otherwise.
  • If you used prependData to inject Sass code, switch to additionalData.
  • When source maps are enabled, some sassOptions source map settings no longer take effect.
  • You need Node.js 10.13 or newer to use this version.
Must act 4 items need code or config changes

Node.js requirement changed in 9.0.0: >= 8.9.0 → >= 10.13.0.

Adds klona ^1.1.2.

Drops clone-deep.

Installs 16 packages in all (was 21).

What you must change

Breaking3
Prefers sass (dart-sass) by default and strongly recommends migrating to it.
sassdart-sass
9.0.0GitHub ReleaseSummarizedView source
Removes the prependData option in favor of the additionalData option.
prependDataadditionalData
9.0.0GitHub ReleaseSummarizedView source
Ignores several sassOptions source map settings when the sourceMap option is true.
sourceMapsassOptions.sourceMapsassOptions.sourceMapContentssassOptions.sourceMapEmbedsassOptions.sourceMapRootsassOptions.omitSourceMapUrl
9.0.0GitHub ReleaseSummarizedView source
Platform1
Raises the minimum supported Node.js version to 10.13.
9.0.0GitHub ReleaseSummarizedView source