Como funciona por dentro
Movido diretamente pelo pacote padrão `semver` usado pelo próprio npm, o testador interpreta conjuntos de comparadores (`^`, `~`, intervalos com hífen, uniões `||`), valida versões com inclusão opcional de prerelease e expõe `semver.compare`, `semver.diff` e `semver.inc`.
Passo a passo de uso
Digite uma expressão de intervalo npm como `^1.2.0` ou `>=1.4.0 <2.0.0`.
Cole as versões candidatas do pacote (uma por linha ou separadas por vírgula) e marque se deseja incluir prereleases.
Confira os limites normalizados, a maior versão compatível (`maxSatisfying`) e o status de cada versão.
Use os cards inferiores para comparar duas versões exatas ou simular incrementos `patch`, `minor`, `major` e `prerelease`.
Principais recursos e vantagens
- Resolução autêntica `semver` do npm garante comportamento idêntico ao `package.json` e lockfiles
- Calcula `maxSatisfying` e `minSatisfying` instantaneamente em qualquer lista de candidatas
- Comparador lado a lado informa a diferença exata de release (`major`, `minor`, `patch`, `prerelease`)
- Simulador interativo de bump de versão para `patch`, `minor`, `major` e prereleases (`alpha`/`beta`/`rc`)
- Roda 100% no navegador sem consultar registros remotos
Metodologia, fórmulas e padrões técnicos
Segue as regras de precedência SemVer 2.0.0 e node-semver do npm, incluindo o comportamento do circunflexo em `0.x.y` (`^0.2.3` equivale a `>=0.2.3 <0.3.0`) e filtragem estrita de prereleases por padrão.
Casos de uso práticos
- Verificar se `^0.14.0` permite acidentalmente atualizações incompatíveis para `0.15.0` no `package.json`
- Testar intervalos compostos (`>=18.0.0 <20.0.0 || ^20.11.0`) antes de alterar `engines.node`
- Calcular exatamente a próxima tag de prerelease (`1.4.2 -> 1.4.3-beta.0`) em dry-runs de CI/CD
- Resolver dúvidas de precedência de versões (`1.5.0-rc.1` vs `1.5.0`) de forma objetiva
Exemplos resolvidos e casos especiais
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`.
Limitações e notas de precisão
- • Avalia a sintaxe SemVer 2.0.0 / npm; variações PEP 440 do Python (`~=`) ou específicas do Cargo fora do SemVer padrão exigem adaptação manual.
- • Não consulta o registro remoto do npm para preservar a privacidade offline.
Processamento local no navegador e privacidade
Conversores comuns enviam seus documentos, códigos ou vídeos para servidores externos. O Testador de Faixas SemVer e Comparador de Versões npm roda direto na sua aba:
Seus textos e arquivos são processados localmente sem enviar conteúdo para servidores.
O Microdeck não registra nem armazena arquivos ou dados colados nas ferramentas.
Os resultados ficam apenas na memória do navegador e somem ao fechar ou limpar a aba.
Perguntas frequentes (FAQ)
Por que `^1.2.0` ignora `1.5.0-alpha.1` por padrão?
Pelas regras SemVer do npm, versões prerelease não correspondem a comparadores a menos que o comparador compartilhe explicitamente a mesma tupla `[major, minor, patch]` ou que o modo prerelease seja ativado.
Qual é a diferença entre `~1.2.3` e `^1.2.3`?
O til `~1.2.3` permite apenas atualizações de patch (`<1.3.0`), enquanto o circunflexo `^1.2.3` permite atualizações minor e patch (`<2.0.0`).
Aceita uniões com `||`?
Sim. Expressões como `^16.0.0 || ^18.0.0` são avaliadas nativamente por `semver.validRange`.
Metadados de build no final (`+build.42`) afetam a precedência?
Não. Conforme a seção 10 da especificação SemVer 2.0.0, metadados de build são ignorados na ordenação de versões.
Outras ferramentas relacionadas
Gerador de .gitignore
Monte arquivos .gitignore limpos para sua stack 100% no navegador
Validador JSON Schema
Valide JSON contra regras JSON Schema 100% no navegador e sem enviar dados
Explicador e Gerador de Expressões Cron
Traduza sintaxe crontab para português claro e veja as próximas 10 execuções