Нарушаването на обратната съвместимост в популярния NPM пакет причинява сривове в различни проекти

Хранилището на NPM претърпява още един масивен срив на проекта поради проблем с нова версия на популярна зависимост. Източникът на проблемите беше новата версия на пакета mini-css-extract-plugin 2.5.0, предназначен да извлича CSS в отделни файлове. Пакетът има повече от 10 милиона изтегляния седмично и се използва като пряка зависимост за повече от 7 проекта.

В новата версия бяха направени промени, които нарушиха обратната съвместимост при импортиране на библиотеката и доведоха до грешка при опит за използване на предишната валидна конструкция "const MiniCssExtractPlugin = require('mini-css-extract-plugin')", описана в документацията , който при преминаване към новата версия трябваше да бъде заменен с "const MiniCssExtractPlugin = require("mini-css-extract-plugin").default".

Проблемът се проявява в проекти, които не се свързват изрично с номера на версията, когато включват зависимости. Като заобиколно решение се препоръчва да коригирате обвързването към предишната версия 2.4.5, като добавите „"overrides": {"mini-css-extract-plugin": "2.4.5"}' в Yarn или използвате командата " npm i -D --save-exact [имейл защитен]» в НПМ.

Сред жертвите бяха потребители на пакета create-react-app, разработен от Facebook, който включва mini-css-extract-plugin като зависимост. Поради липсата на обвързване с номера на версията на mini-css-extract-plugin, опитите за стартиране на create-react-app завършиха с грешката „TypeError: MiniCssExtractPlugin не е конструктор“. Проблемът също засегна пакети @wordpress/scripts, @auth0/auth0-spa-js, sql-formatter-gui, LedgerSMB, vip-go-mu-plugins, cybros, vue-cli, chore и др.

Източник: opennet.ru