全新 JS API 發佈候選版本現已推出

由 Natalie Weizenbaum 發佈於 2021 年 11 月 21 日

我們幾個月前宣布的全新 JavaScript API 現已在 Dart Sass 中完整實作,準備好讓您體驗!全新 API 的設計比舊版更符合程式語言習慣、效能更佳且更易於使用,我們希望它能迅速地被工具套件採用。

由於這是一項重大的新增功能,我們希望在正式發佈前讓使用者有機會先行試用,因此我們在 Dart Sass 1.45.0-rc.1 中以發佈候選版本的型式推出。立即下載、試用,並透過提交 issue發送推文讓我們知道您的想法。除非有必要進行重大修改,否則我們計劃在下週的某個時間點推出穩定版本。

如何使用如何使用永久連結

全新 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 文件以取得更多關於 API 的詳細資訊,包括全新的 importer 和自訂函式 API。

舊版 API 的未來發展舊版 API 的未來發展永久連結

一旦全新 API 推出穩定版本,我們將正式將舊版 API 標記為已棄用。由於它仍然被廣泛使用,我們將在未來很長一段時間內繼續維護它。預計它將在大約一年後開始顯示棄用警告,並在我們發佈 Dart Sass 2.0.0 時正式停用。