작동 원리 및 구조
npm 자체에서 사용하는 표준 `semver` 패키지를 직접 구동해 비교기 집합(`^`, `~`, 하이픈 범위, `||` 합집합)을 파싱하고, 프리릴리스 포함 여부에 따라 후보 버전을 검사 및 정렬하며 `semver.compare`, `semver.diff`, `semver.inc` 결과를 즉시 제공합니다.
단계별 사용 방법
`^1.2.0` 또는 `>=1.4.0 <2.0.0` 같은 npm 버전 범위 표현식을 입력합니다.
검사할 후보 패키지 버전 목록(줄바꿈 또는 쉼표 구분)을 붙여넣고 필요 시 프리릴리스 포함 토글을 켭니다.
정규화된 범위 경계, 가장 높은 일치 버전(`maxSatisfying`), 각 버전의 통과/제외 배지를 확인합니다.
하단 카드를 사용해 두 버전을 직접 비교하거나 `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 규정에 따라 빌드 메타데이터는 버전 우선순위 정렬에 영향을 미치지 않습니다.
관련 마이크로 도구 살펴보기
스택별 .gitignore 생성기 & 중복 제거기
Node, Astro, Python, Rust, Go, macOS, VS Code, Docker 프리셋을 조합해 중복 없는 깔끔한 .gitignore 생성
JSON 스키마 검증기 (JSON Schema Validator)
서버 전송 없이 브라우저에서 JSON Schema 규칙(`required`, `type`, `enum`, `format`, `additionalProperties`)을 즉시 검증
Cron 표현식 해석기 & 실행 타임라인
복잡한 크론(Crontab) 구문을 쉬운 말로 풀고 향후 10회 실행 시간을 확인하세요