Проверка Semver
Проверяйте, сравнивайте и сортируйте семантические версии, а также проверяйте их на соответствие диапазонам в стиле npm, например ^1.2.0, ~2.4, >=1.0.0 <2.0.0, 1.x или 1.2.3 - 2.3.4. Проверка учитывает правила Semantic Versioning 2.0.0 для предварительных выпусков и метаданных сборки, а также те же правила диапазонов, что и пакет semver от npm, показывает, какие версии охватывает диапазон, и находит наибольшую подходящую версию.
Часто задаваемые вопросы
Что делает проверка?
Она анализирует каждую введенную версию, сообщает, является ли она допустимой семантической версией, сортирует допустимые версии и указывает наибольшую. Если вы введете диапазон, она также сообщит, какие версии ему соответствуют и какая из них наибольшая. Если введены ровно две версии, она также укажет, какая из них выше.
Что означает ^1.2.3?
Каретка допускает изменения, которые не затрагивают самую левую ненулевую цифру. ^1.2.3 означает >=1.2.3 <2.0.0, ^0.2.3 означает >=0.2.3 <0.3.0, а ^0.0.3 означает только 0.0.3. Это значение по умолчанию у npm при установке пакета.
Что означает ~1.2.3?
Тильда допускает обновления исправлений: ~1.2.3 означает >=1.2.3 <1.3.0. Если указана только основная версия, ~1 означает >=1.0.0 <2.0.0. Используйте этот вариант, если вам нужны исправления ошибок без новых возможностей в минорных версиях.
Какие синтаксические формы диапазонов поддерживаются?
Операторы сравнения (<, <=, >, >=, =), диапазоны с кареткой и тильдой, диапазоны X, например 1.x, 1.2.* и *, неполные версии, например 1.2, диапазоны с дефисом, например 1.2.3 - 2.3.4, несколько разделенных пробелами операторов сравнения, которым должны соответствовать все версии, а также альтернативы, разделенные ||.
Как сравниваются предварительные версии?
Предварительная версия, например 1.0.0-beta.2, ниже релизной версии 1.0.0. Идентификаторы предварительного выпуска сравниваются по очереди: числа — численно, текст — в алфавитном порядке; число всегда ниже текста. Поэтому 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.
Почему 2.0.0-beta не соответствует ^1.2.0?
Согласно npm, предварительная версия соответствует диапазону, только если один из операторов сравнения в диапазоне указывает предварительную версию с теми же значениями основной, дополнительной и исправительной версий. Это не позволяет случайно включить нестабильные версии. Включите параметр «Включать предварительные версии», чтобы они соответствовали диапазонам как обычные версии; как и в npm, тогда нижние границы неполных диапазонов и диапазонов с дефисом тоже будут включать предварительные версии.
Что показывает развернутый диапазон?
Проверка показывает диапазон в виде обычных операторов сравнения, которые он представляет. Например, ^1.2.3 = >=1.2.3 <2.0.0-0. Суффикс -0 означает, что граница также исключает предварительные версии 2.0.0 — именно так его записывает пакет semver от npm.
Учитываются ли метаданные сборки при сравнении?
Нет. При сравнении Semantic Versioning игнорирует метаданные сборки — часть после знака плюса, поэтому 1.0.0+build.1 и 1.0.0+build.2 равны. Проверка показывает метаданные, но не использует их при сортировке и проверке диапазонов.
Принимаются ли версии с начальной v?
Да. Начальная v игнорируется, поэтому v1.2.3 читается как 1.2.3, как это делает npm. Версии менее чем с тремя числами, например 1.2, недопустимы, но работают в диапазонах: там 1.2 означает любую версию 1.2.x.
Сколько версий можно проверить?
До 200 версий за запрос, по одной в строке; длина диапазона — до 1,000 символов.