Microdeck.tools 100% 브라우저 실행

SemVer 버전 범위 & npm 패키지 버전 테스터

New

npm 공식 `semver` 스펙 엔진으로 패키지 버전 제약을 검증하세요. `^1.2.0` 또는 `>=2.0.0 <2.5.0` 표현식에 어떤 후보 버전이 부합하는지 확인하고, `minSatisfying` / `maxSatisfying` 조회, 두 버전 비교(`major`/`minor`/`patch` 차이) 및 다음 범프(Bump) 버전을 미리 봅니다.

100% 브라우저 실행 서버 업로드 없음 즉시 결과 확인

npm SemVer Range Matcher

Normalized: >=1.2.0 <2.0.0-0Max: 1.9.2Min: 1.2.4
0.9.8excluded
1.0.0excluded
1.2.4satisfies
1.5.0-alpha.1excluded
1.5.0satisfies
1.9.2satisfies
2.0.0excluded
2.1.0excluded

Compare Two Versions

1.4.2 is older than 1.5.0-rc.1
Release diff: preminor

Bump Release Calculator

patch: 1.4.3
minor: 1.5.0
major: 2.0.0
pre: 1.4.3-beta.0

이 도구가 시간을 절약하는 데 도움이 되었나요? Microdeck을 무료로 유지하고 개선하는 데 힘을 보태주세요. 자율 참여 · $3부터.

작동 원리 및 구조

npm 자체에서 사용하는 표준 `semver` 패키지를 직접 구동해 비교기 집합(`^`, `~`, 하이픈 범위, `||` 합집합)을 파싱하고, 프리릴리스 포함 여부에 따라 후보 버전을 검사 및 정렬하며 `semver.compare`, `semver.diff`, `semver.inc` 결과를 즉시 제공합니다.

단계별 사용 방법

1

`^1.2.0` 또는 `>=1.4.0 <2.0.0` 같은 npm 버전 범위 표현식을 입력합니다.

2

검사할 후보 패키지 버전 목록(줄바꿈 또는 쉼표 구분)을 붙여넣고 필요 시 프리릴리스 포함 토글을 켭니다.

3

정규화된 범위 경계, 가장 높은 일치 버전(`maxSatisfying`), 각 버전의 통과/제외 배지를 확인합니다.

4

하단 카드를 사용해 두 버전을 직접 비교하거나 `patch`, `minor`, `major`, `prerelease` 버전 업 결과를 미리 확인하세요.

주요 기능 및 장점

  • npm 공식 `semver` 엔진 기반으로 `package.json` 및 lockfile 동작과 100% 동일한 결과 보장
  • 임의의 후보 목록에서 `maxSatisfying`과 `minSatisfying` 버전을 즉시 계산
  • 두 버전 나란히 비교기로 정확한 릴리스 차이(`major`, `minor`, `patch`, `prerelease`) 판별
  • 인터랙티브 버전 범프 계산기로 `patch`, `minor`, `major` 및 `alpha`/`beta`/`rc` 프리릴리스 증가 미리보기
  • 레지스트리 폴링 없이 100% 클라이언트 브라우저에서 실행

계산 방식, 공식 및 기술 표준

SemVer 2.0.0 및 npm node-semver 우선순위 규칙을 준수하며, `0.x.y`에서의 캐럿 동작(`^0.2.3` -> `>=0.2.3 <0.3.0`)과 엄격한 프리릴리스 옵트인(Opt-in) 게이팅까지 동일하게 적용됩니다.

실제 활용 사례

  • `package.json`에 적은 `^0.14.0` 범위가 호환성이 깨지는 `0.15.0` 업그레이드를 허용하지는 않는지 사전 검증
  • `engines.node` 수정 전 복합 범위(`>=18.0.0 <20.0.0 || ^20.11.0`)의 매칭 동작 테스트
  • CI/CD 배포 드라이 런 중 정확한 다음 프리릴리스 태그(`1.4.2 -> 1.4.3-beta.0`) 계산
  • 버전 우선순위(`1.5.0-rc.1` vs `1.5.0`)에 대한 팀 내 의문 즉시 해소

입출력 예시 및 엣지 케이스

Zero-Major Caret Behavior

입력
Range: ^0.2.3 | Candidates: 0.2.9, 0.3.0
출력
Matches: 0.2.9 (maxSatisfying) | Excluded: 0.3.0

In `0.x.y`, caret locks the minor digit because breaking changes happen in minor bumps.

Prerelease Precedence

입력
Left: 1.4.2 | Right: 1.5.0-rc.1
출력
1.4.2 is older than 1.5.0-rc.1 (diff: premajor/preminor)

Prerelease comes before `1.5.0` final, after `1.4.2`.

제한 사항 및 정확도 안내

  • • SemVer 2.0.0 및 npm 문법을 기준으로 평가하므로 Python PEP 440(`~=`)이나 Cargo 고유의 미세 변형 문법은 수동 변환이 필요합니다.
  • • 오프라인 프라이버시를 위해 원격 npm 레지스트리에 버전을 조회하지는 않습니다.

브라우저 로컬 처리 및 개인정보 보호

일반 웹 변환기는 문서나 미디어 파일을 원격 서버에 업로드합니다. SemVer 버전 범위 & npm 패키지 버전 테스터 도구는 현재 브라우저 탭 내부에서만 실행됩니다:

현재 탭에서 직접 처리

입력 텍스트와 파일은 외부 서버로 전송되지 않고 기기 내에서 로컬로 계산됩니다.

입력 데이터 로그 미보관

도구에 붙여넣은 파일이나 데이터를 서버에 기록하거나 저장하지 않습니다.

일시적 탭 메모리 수명주기

작업 결과는 브라우저 탭 메모리에만 유지되며 탭을 닫거나 초기화하면 즉시 해제됩니다.

자주 묻는 질문 (FAQ)

`^1.2.0` 범위가 기본적으로 `1.5.0-alpha.1`을 무시하는 이유는 무엇인가요?

npm SemVer 규칙상 비교기 범위와 동일한 `[major, minor, patch]` 튜플을 공유하거나 프리릴리스 포함 모드를 명시적으로 켜지 않으면 프리릴리스 버전은 매칭에서 제외됩니다.

`~1.2.3`과 `^1.2.3`의 차이점은 무엇인가요?

틸드(`~1.2.3`)는 패치 업데이트(`<1.3.0`)까지만 허용하고, 캐럿(`^1.2.3`)은 마이너와 패치 업데이트(`<2.0.0`)까지 모두 허용합니다.

`||` 합집합 범위 표현식도 지원하나요?

네. `^16.0.0 || ^18.0.0` 같은 표현식도 `semver.validRange`를 통해 네이티브로 평가됩니다.

뒤에 붙는 빌드 메타데이터(`+build.42`)는 버전 크기 비교에 영향을 주나요?

아니요. SemVer 2.0.0 §10 규정에 따라 빌드 메타데이터는 버전 우선순위 정렬에 영향을 미치지 않습니다.

관련 마이크로 도구 살펴보기

Microdeck 후원하기

100% 자율 후원 · $3부터 · 회원가입 불필요

금액 선택 (USD):선택 금액:$5

최소 후원 금액은 $3 USD입니다.

100% 자율 · $3부터 · Gumroad 안전 결제 창이 열립니다.