Dependency range evaluator

Zobacz dokładnie, które wersje dopuszcza semver range

Wklej range, porównaj wersje paczki i sprawdź znormalizowany zestaw comparatorów przed zmianą package.json. Worker działa lokalnie, nie pobiera metadanych npm i jawnie pokazuje prerelease behavior.

Bez registry lookup
Prerelease toggle
Version matrix

Użyj przed review polityki zależności

Semver ranges wyglądają krótko, ale decydują o oknie upgrade'u, ekspozycji na prerelease i bezpieczeństwie 0.x. Ten playground zamienia ranges na comparator sets, min/max satisfying versions i macierz wersji widoczną w review.

Interaktywne uruchomienie w przeglądarce ewaluuje zakres przez paczkę npm semver w workerze. Strona nie pobiera metadanych paczek, nie odpytuje registry.npmjs.org i nie zapisuje wklejonych list wersji.

PresetSortowanie wersjiLoose parsingUwzględnij prerelease

Pokazuje typowy domyślny zakres npm: dopuszcza kompatybilne wydania 1.x od 1.2.3, ale zatrzymuje się przed 2.0.0.

Range input

RangeWersje, oddzielone liniami, spacjami lub przecinkami

Wynik ewaluacji

Znormalizowany range>=1.2.3 <2.0.0-0

Matches3/6

Min version1.2.3

Czas5 ms

Min satisfying: 1.2.3
Max satisfying: 1.9.9

Comparator sets

>=1.2.3 <2.0.0-0

Macierz wersji

1.2.21.2.2 NO MATCH

1.2.31.2.3 MATCH

1.3.01.3.0 MATCH

1.9.91.9.9 MATCH

2.0.0-beta.12.0.0-beta.1 NO MATCH

2.0.02.0.0 NO MATCH

Snippet semver do skopiowania

import { maxSatisfying, satisfies, validRange } from 'semver';

const range = "^1.2.3";
const versions = [
  "1.2.2",
  "1.2.3",
  "1.3.0",
  "1.9.9",
  "2.0.0",
  "2.0.0-beta.1"
];
const options = {};

const normalizedRange = validRange(range, options);
const matching = versions.filter((version) => satisfies(version, range, options));
const latestAllowed = maxSatisfying(versions, range, options);

console.log({ normalizedRange, matching, latestAllowed });

Notatki do review range

Caret i tilde to decyzje polityki

Caret zwykle otwiera szersze kompatybilne okno niż tilde. Dla bibliotek z dobrą kompatybilnością to może być korzystne. Dla kruchych integracji węższy tilde lane bywa łatwiejszy do review.

0.x jest celowo wąskie

Caret range poniżej 1.0.0 nie zachowuje się jak stabilny major range. ^0.2.3 zatrzymuje się przed 0.3.0, a ^0.0.3 akceptuje tylko patch-compatible releases.

Prerelease matching jest jawny

Prerelease versions są wykluczone, chyba że ta sama wersja bazowa uczestniczy w range albo includePrerelease jest włączone. To chroni przed przypadkową adopcją beta podczas zwykłych upgrade'ów.

Użyj ich, gdy polityka zależności łączy się z formatowaniem dat, opcjami TypeScript compiler albo review kontraktów schema.

Testuj npm semver ranges przed dependency review

Semver Range Playground to privacy-first evaluator zakresow zaleznosci do review package.json. Wklej range, dodaj candidate versions i sprawdź normalized comparators, minVersion, minSatisfying, maxSatisfying oraz macierz matchy. Interaktywne uruchomienia w przeglądarce uzywaja paczki npm semver w workerze; trasa nie odpytuje registry.npmjs.org, nie pobiera metadanych paczek i nie wysyła wklejonych wersji do backendu.

Co obejmuje MVP

MVP pokrywa range shapes, które zespoly najczesciej omawiaja przy maintenance zaleznosci: caret ranges, tilde ranges, granice 0.x, x-ranges, hyphen ranges, OR ranges i prerelease handling. Narzedzie raportuje kontrolowane diagnostyki dla invalid range, invalid version, duplicate normalized version, empty list, oversized input, prerelease exclusion, no matches, worker timeout i worker error.

Dlaczego semver range review potrzebuje widocznej macierzy

Dependency range to decyzja polityki ukryta w krotkim stringu. Reviewer musi wiedziec, czy patch-only lane jest intencjonalny, czy paczka 0.x może przejsc na kolejny minor, czy OR range zostawia legacy lane oraz czy prerelease versions są swiadomie wlaczone. Widoczna macierz wersji ulatwia omowienie tych tradeoffow zanim zmiana trafi do CI albo produkcji. Normalized comparator output pomaga też wyjasnic, dlaczego ^1.2.3, ~1.2.3, 1.2.x i 1.2.3 - 2.3 nie oznaczaja tego samego okna upgrade. Widoczna macierz ogranicza dwa czeste błędy review. Pierwszy błąd to czytanie range jak jednej wersji. Regula typu ^1.2.3 nie dotyczy tylko 1.2.3; opisuje ruchome okno, które może wpuscic pozniejsze minor i patch releases. To pomaga w utrzymaniu, ale powinno byc swiadome, gdy paczka ma wrazliwe public API, peer dependency boundary albo runtime behavior zmieniony w ostatnich wydaniach. Drugi błąd to traktowanie kazdej paczki 0.x tak samo jak stabilnej 1.x. W npm semver caret dla 0.x jest wezszy, bo lewy niezerowy segment niesie znaczenie compatibility. Pokazanie 0.2.9, 0.3.0 i 1.0.0 obok tej samej reguly ulatwia wyjasnienie tej granicy w pull requescie. Prerelease wymaga osobnej linii w review, bo w tym miejscu często pojawiaja się zaskoczenia. Range może wyglądać szeroko, ale prerelease versions są zwykle odrzucane, dopoki regula albo opcja jawnie ich nie dopuszcza. To ma znaczenie, gdy zespol testuje beta, rc albo next tags przed major release. Playground nie zgaduje intencji projektu. Pokazuje te same kandydackie wersje z wlaczonym i wylaczonym prerelease, żeby reviewer mogl zdecydowac, czy package.json ma pozostac konserwatywny, przejsc na jawny prerelease target albo poczekac na stabilne wydanie. Dzięki temu trasa jest powierzchnia decyzyjna, a nie symulatorem package managera.