Eine Inkompatibilität in einem beliebten NPM-Paket führte zu Ausfällen in verschiedenen Projekten.

Im NPM-Repository gibt es erneut einen weitreichenden Ausfall von Projekten aufgrund von Problemen in einer neuen Version eines beliebten Pakets. Die Quelle der Probleme ist die neue Version des Pakets mini-css-extract-plugin 2.5.0, das dazu dient, CSS in separate Dateien zu extrahieren. Das Paket hat mehr als 10 Millionen wöchentliche Downloads und wird als direkte Abhängigkeit von über 7.000 Projekten verwendet.

In der neuen Version wurden Änderungen vorgenommen, die die Abwärtskompatibilität beim Import der Bibliothek beeinträchtigen und zu Fehlerausgaben führen, wenn versucht wird, die zuvor zulässige und in der Dokumentation beschriebene Konstruktion „const MiniCssExtractPlugin = require('mini-css-extract-plugin')“ zu verwenden. Bei der Umstellung auf die neue Version musste diese durch „const MiniCssExtractPlugin = require('mini-css-extract-plugin').default“ ersetzt werden.

Das Problem trat in Projekten auf, die keine explizite Bindung an die Versionsnummer bei der Einbindung von Abhängigkeiten verwenden. Als vorübergehende Lösung wird empfohlen, die Bindung an die frühere Version 2.4.5 festzulegen, indem ‘„overrides“: {„mini-css-extract-plugin“: „2.4.5“}’ in Yarn hinzugefügt wird oder der Befehl „npm i -D --save-exact mini-css-extract-plugin@2.4.5“ in NPM verwendet wird.

Unter den Betroffenen befinden sich Nutzer des von Facebook entwickelten Pakets create-react-app, das mini-css-extract-plugin als Abhängigkeit einbindet. Aufgrund des Fehlens einer Versionsbindung führten Versuche, create-react-app zu starten, zur Fehlermeldung "TypeError: MiniCssExtractPlugin is not a constructor". Auch Pakete wie @wordpress/scripts, @auth0/auth0-spa-js, sql-formatter-gui, LedgerSMB, vip-go-mu-plugins, cybros, vue-cli, chore usw. waren betroffen.

Quelle: opennet.ru