Проверка на 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?
Caret позволява промени, които не променят най-левия ненулев номер. ^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?
Tilde позволява актуализации на корекциите: ~1.2.3 означава >=1.2.3 <1.3.0. Само с основна версия ~1 означава >=1.0.0 <2.0.0. Използвайте го, когато искате корекции на грешки, но не и нови второстепенни функции.
Кои синтаксиси за диапазони се поддържат?
Сравнителни оператори (<, <=, >, >=, =), диапазони с caret и tilde, диапазони 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 знака.