Walidator semver
Sprawdzaj, porównuj i sortuj wersje semantyczne oraz testuj je względem zakresów w stylu npm, takich jak ^1.2.0, ~2.4, >=1.0.0 <2.0.0, 1.x lub 1.2.3 - 2.3.4. Walidator stosuje reguły Semantic Versioning 2.0.0 dotyczące wydań przedpremierowych i metadanych kompilacji oraz te same reguły zakresów co pakiet semver w npm, pokazuje rozwinięcie zakresu i znajduje najwyższą wersję, która go spełnia.
Najczęściej zadawane pytania
Co robi walidator?
Analizuje każdą podaną wersję, informuje, czy jest poprawną wersją semantyczną, sortuje poprawne wersje i wskazuje najwyższą. Po podaniu zakresu informuje, które wersje go spełniają i która z nich jest najwyższa. Gdy podasz dokładnie dwie wersje, wskazuje też, która jest wyższa.
Co oznacza ^1.2.3?
Karet pozwala na zmiany, które nie modyfikują najbardziej znaczącej liczby różnej od zera. ^1.2.3 oznacza >=1.2.3 <2.0.0, ^0.2.3 oznacza >=0.2.3 <0.3.0, a ^0.0.3 oznacza tylko 0.0.3. To domyślne ustawienie pakietu npm podczas instalowania pakietu.
Co oznacza ~1.2.3?
Tylda pozwala na aktualizacje poprawek: ~1.2.3 oznacza >=1.2.3 <1.3.0. Jeśli podano tylko wersję główną, ~1 oznacza >=1.0.0 <2.0.0. Użyj jej, gdy chcesz otrzymywać poprawki błędów, ale bez nowych funkcji pomniejszych.
Jakie składnie zakresów są obsługiwane?
Operatory porównania (<, <=, >, >=, =), zakresy z karetem i tyldą, zakresy X, takie jak 1.x, 1.2.* i *, niepełne wersje, takie jak 1.2, zakresy z łącznikiem, takie jak 1.2.3 - 2.3.4, kilka operatorów porównania oddzielonych spacjami, które wszystkie muszą pasować, oraz alternatywy oddzielone przez ||.
Jak porównywane są wersje przedpremierowe?
Wersja przedpremierowa, taka jak 1.0.0-beta.2, jest niższa od wydania 1.0.0. Identyfikatory wersji przedpremierowej są porównywane kolejno: liczby numerycznie, tekst alfabetycznie, a liczba jest zawsze niższa od tekstu, więc 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.
Dlaczego 2.0.0-beta nie spełnia ^1.2.0?
Zgodnie z npm wersja przedpremierowa spełnia zakres tylko wtedy, gdy jeden z jego operatorów porównania wskazuje wersję przedpremierową o tej samej wersji głównej, pomniejszej i poprawkowej. Dzięki temu zakresy nie uwzględniają przypadkowo niestabilnych wersji. Włącz opcję Uwzględnij wersje przedpremierowe, aby dopasowywać je jak zwykłe wersje; tak jak w npm, dolne granice niepełnych zakresów i zakresów z łącznikiem również obejmują wtedy wersje przedpremierowe.
Czym jest rozwinięcie zakresu?
Walidator pokazuje zakres jako operatory porównania, które on reprezentuje, na przykład ^1.2.3 = >=1.2.3 <2.0.0-0. Sufiks -0 oznacza, że granica wyklucza również wersje przedpremierowe 2.0.0, dokładnie tak, jak zapisuje to pakiet semver w npm.
Czy porównywane są metadane kompilacji?
Nie. Semantic Versioning pomija metadane kompilacji, czyli część po znaku plusa, podczas porównywania, więc 1.0.0+build.1 i 1.0.0+build.2 są równe. Walidator pokazuje metadane, ale nie używa ich do sortowania ani obsługi zakresów.
Czy akceptowane są wersje z początkowym v?
Tak. Początkowe v jest ignorowane, więc v1.2.3 jest odczytywane jako 1.2.3, tak jak robi to npm. Wersje zawierające mniej niż trzy liczby, takie jak 1.2, nie są poprawnymi wersjami, ale działają w zakresach, gdzie 1.2 oznacza dowolną wersję 1.2.x.
Ile wersji mogę sprawdzić?
Do 200 wersji w jednym żądaniu, po jednej w wierszu, oraz zakres o długości do 1,000 znaków.