Verificador de Semver
Verifique, compare e ordene versões semânticas e teste-as com intervalos no estilo npm, como ^1.2.0, ~2.4, >=1.0.0 <2.0.0, 1.x ou 1.2.3 - 2.3.4. O verificador segue as regras de Semantic Versioning 2.0.0 para pré-lançamentos e metadados de build, além das mesmas regras de intervalo do pacote semver de npm, mostra a expansão de um intervalo e encontra a versão mais alta que o satisfaz.
Perguntas frequentes
O que o verificador faz?
Ele analisa cada versão informada, indica se é uma versão semântica válida, ordena as válidas e identifica a mais alta. Quando você informa um intervalo, também mostra quais versões o satisfazem e qual delas é a mais alta. Com exatamente duas versões, também indica qual é a maior.
O que significa ^1.2.3?
O caret permite alterações que não modificam o número não zero mais à esquerda. ^1.2.3 significa >=1.2.3 <2.0.0, ^0.2.3 significa >=0.2.3 <0.3.0 e ^0.0.3 significa apenas 0.0.3. Esse é o padrão de npm ao instalar um pacote.
O que significa ~1.2.3?
O til permite atualizações de patch: ~1.2.3 significa >=1.2.3 <1.3.0. Com apenas uma versão principal, ~1 significa >=1.0.0 <2.0.0. Use-o quando quiser correções de bugs, mas nenhum novo recurso secundário.
Quais sintaxes de intervalo são compatíveis?
Comparadores (<, <=, >, >=, =), intervalos com caret e til, intervalos X como 1.x, 1.2.* e *, versões parciais como 1.2, intervalos com hífen como 1.2.3 - 2.3.4, vários comparadores separados por espaços que devem corresponder todos, e alternativas separadas por ||.
Como as versões de pré-lançamento são comparadas?
Um pré-lançamento como 1.0.0-beta.2 é inferior à versão final 1.0.0. Os identificadores de pré-lançamento são comparados um a um: números numericamente, textos em ordem alfabética, e um número é sempre inferior a um texto; portanto, 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.
Por que 2.0.0-beta não satisfaz ^1.2.0?
De acordo com npm, um pré-lançamento só satisfaz um intervalo quando um dos comparadores do intervalo especifica um pré-lançamento da mesma versão principal, secundária e de patch. Assim, os intervalos não incluem versões instáveis por acidente. Ative Incluir pré-lançamentos para permitir que correspondam como versões normais; como em npm, os limites inferiores de intervalos parciais e com hífen também passam a incluir pré-lançamentos.
O que é a expansão do intervalo?
O verificador mostra o intervalo como os comparadores simples que ele representa. Por exemplo, ^1.2.3 = >=1.2.3 <2.0.0-0. O sufixo -0 significa que o limite também exclui os pré-lançamentos de 2.0.0, exatamente como o pacote semver de npm o escreve.
Os metadados de build são comparados?
Não. O Semantic Versioning ignora os metadados de build, a parte após o sinal de mais, durante a comparação; por isso, 1.0.0+build.1 e 1.0.0+build.2 são iguais. O verificador mostra os metadados, mas não os usa na ordenação nem nos intervalos.
Versões com v inicial são aceitas?
Sim. O v inicial é ignorado, então v1.2.3 é interpretado como 1.2.3, assim como npm faz. Versões com menos de três números, como 1.2, não são válidas, mas funcionam em intervalos, nos quais 1.2 significa qualquer versão 1.2.x.
Quantas versões posso verificar?
Até 200 versões por solicitação, uma por linha, e um intervalo de até 1,000 caracteres.