Sass docs recommends @use over @import without clarifying node-sass does not support @use

[wu-lee]

The Sass docs say here:

The Sass team discourages the continued use of the @import rule. Sass will gradually phase it out over the next few years, and eventually remove it from the language entirely. Prefer the @use rule instead.

However, I cannot get @use to work. I now know the reason, which is that node-sass does not support it. However, there are no errors raised at the point of the @use declaration. Instead they suggest an error later in the source where I attempt to utilise the imported symbols:

Invalid CSS after "...nd-color: color": expected expression (e.g. 1px, bold), was ".adjust($primary-co"

Only after an intensive search did I find out the real cause, from posts such as this one, which also illustrates the case in point:

https://stackoverflow.com/questions/60920833/gatsby-fails-after-using-sass-files-with-use-sasscolor

To help future users avoid an unnecessary hunt, at least until node-sass is no-longer the default in ecosystems like Gatsby, please could the documentation state clearly that node-sass does not support @use, next to the advice to prefer @use to over @import

[nex3]

At the very top of the @use documentation is a compatibility header that describes exactly which implementation support it, as well as a drop-down that provides more details:

[wu-lee]

I don't deny this. I humbly suggest that something more along the lines of the very noticeable warnings like this (image below) are warrented. Especially so, because the error messages from libsass are misleading:

Possibly this seems a small thing to you, but for others it could save a lot of time.

[Awjin]

@wu-lee This was fixed in #481