2.5 KiB
resolve-url-loader
Version 4
Features
- Better resolution of the original source location - You can more successfully use
url()
in variables and mixins. - Dependencies now accept a wider range and explicit dependency on
rework
andrework-visit
has been removed.
Breaking Changes
- The
engine
option is deprecated which means the oldrework
engine is deprecated. - The
keepQuery
behaviour is now the default, thekeepQuery
option has been removed. - The
removeCR
option defaults totrue
when executing on Windows OS. - The
absolute
option has been removed. - The
join
option has changed.
Migrating
Remove the engine
option if you are using it - the default "postcss" engine is much more reliable. The "rework" engine will still work for now but will be removed in the next major version.
Remove the keepQuery
option if you are using it.
Remove the absolute
option, webpack should work fine without it. If you have a specific need to rebase url()
then you should use a separate loader.
If you use a custom join
function then you will need to refactor it to the new API. Refer to the advanced usage documentation.
If you wish to still use engine: "rework"
then note that rework
and rework-visit
packages are now peerDependencies
that must be explicitly installed by you.
Version 3
Features
-
Use
postcss
parser by default. This is long overdue as the oldrework
parser doesn't cope with modern css. -
Lots of automated tests running actual webpack builds. If you have an interesting use-case let me know.
Breaking Changes
- Multiple options changed or deprecated.
- Removed file search "magic" in favour of
join
option. - Errors always fail and are no longer swallowed.
- Processing absolute asset paths requires
root
option to be set.
Migrating
Initially set option engine: 'rework'
for parity with your existing build. Once working you can remove this option or set engine: 'postcss'
explicitly.
Retain keepQuery
option if you are already using it.
The root
option now has a different meaning. Previously it limited file search. Now it is the base path for absolute or root-relative URIs, consistent with css-loader
. If you are already using it you can probably remove it.
If you build on Windows platform and your content contains absolute asset paths, then css-loader
could fail. The root
option here may fix the URIs before they get to css-loader
. Try to leave it unspecified, otherwise (windows only) set to empty string root: ''
.