Node.js 22.0.0–22.10.xを使用している場合、Gulpを使用したSXA CLI Sassコンパイルが失敗する


解説

Node.jsバージョン22.0.0–22.10.xで、gulp-sass、gulp、または類似のツールを使用したSCSSのCSSへのコンパイルが、以下のランタイム エラーで失敗する可能性があります。

TypeError in plugin "sass"
Message:
    Cannot assign to read only property 'ctime' of object '#<Stats>'

このエラーは、Node.js 22.0.0ではfs.Statsオブジェクトの内部プロパティが読み込み専用に変更されているにも関わらず、Gulpツールではそれらのプロパティが変更可能なものとして扱われるために発生します。その結果、.scssファイルが変更されるたびにビルドのプロセスがクラッシュします。

この問題は、22.0.0より前のNode.jsバージョンでは発生せず、Node.js 22.11.0で正式に修正されました。

解決策

この問題を解決するには、Node.jsバージョン22.11.0以降にアップグレードしてください。

または、Node.js 21.xもしくはバージョン20.0などの長期サポート対応のバージョンを使用することも可能です。