新的 JS API 发布候选版本现已上线
发布日期:2021 年 11 月 21 日 作者:Natalie Weizenbaum
我们几个月前宣布的新的 JavaScript API 现已在 Dart Sass 中完全实现,并准备供您尝试!新的 API 旨在比旧 API 更符合习惯、更高效、更易用,我们希望它能很快被工具包采用。
由于这是一个如此重大的补充,我们希望在将其定型之前给用户一个尝试的机会,因此我们在 Dart Sass 1.45.0-rc.1 中发布了它作为发布候选版本。下载它,试用一下,并通过 [提交问题](https://github.com/sass/sass/issues/new) 或 [发送推文](https://twitter.com/SassCSS) 让我们知道您的想法。除非需要进行重大更改,否则我们计划在下周某个时间发布稳定版本。
如何使用它如何使用它永久链接
新的 API 附带四个新的入口函数:compile()
和 compileAsync()
接受 Sass 文件路径并返回将它们编译为 CSS 的结果,而 compileString()
和 compileStringAsync()
接受 Sass 源代码字符串并将其编译为 CSS。与旧的 API 不同,异步函数都返回 Promise。与旧的 API 一样,同步函数比异步函数快得多,因此我们建议尽可能使用它们。
const sass = require('sass');
const result = sass.compileString(`
h1 {
font-size: 40px;
code {
font-face: Roboto Mono;
}
}`);
console.log(result.css);
查看 [API 文档](/documentation/js-api) 以了解有关 API 的更多详细信息,包括全新的导入程序和自定义函数 API。
旧的 API 怎么办?旧的 API 怎么办?永久链接
一旦新的 API 发布稳定版本,我们将正式将旧的 API 视为已弃用。由于它仍然被广泛使用,我们将继续维护它很长一段时间。预计它将在一年左右开始打印弃用警告,并在我们发布 Dart Sass 2.0.0 时永久停用。