Compare números de versão semântica pelas regras SemVer

Compare dois números de versão semântica sem depender de ordenação lexical, conversão de ponto flutuante ou atalhos específicos de gerenciadores de pacotes. Esta capacidade valida as duas entradas conforme o Semantic Versioning 2.0.0 e aplica as regras oficiais de precedência aos componentes principal, secundário, de correção e de pré-lançamento. Ela informa se a primeira versão tem precedência menor, maior ou igual à segunda e ignora corretamente os metadados de compilação. Versões inválidas ou incompletas geram um erro de entrada claro, em vez de uma ordenação enganosa.

Compare versões com as regras usadas em lançamentos de software

A comparação comum de textos fornece a resposta errada para muitos números de versão. Por exemplo, uma ordenação lexical pode colocar 2.10.0 antes de 2.9.0 porque compara o caractere 1 com o 9, enquanto a conversão numérica elimina o significado separado das posições principal, secundária e de correção. Este comparador analisa cada posição obrigatória de forma independente e as compara da esquerda para a direita.

Ele também rejeita formatos flexíveis, como a ausência do componente de correção, uma v inicial ou um identificador numérico principal com zero à esquerda. Essa validação rigorosa é valiosa em scripts de implantação, registros de pacotes, serviços de atualização e verificações de CI, pois dados malformados não passam silenciosamente como lançamentos legítimos. Envie a primeira e a segunda versões exatamente como foram publicadas.

O resultado contém uma precedência com sinal: menos um significa que a primeira é menor, zero indica equivalência e um significa que a primeira é maior. Um campo descritivo facilita o uso da mesma resposta em interfaces e condições de fluxo.

Entenda a ordem de pré-lançamento e os metadados de compilação

Os identificadores de pré-lançamento são o ponto em que comparadores simplistas mais falham. Um lançamento com sufixo de pré-lançamento tem precedência menor que a mesma versão principal, secundária e de correção sem o sufixo; portanto, 1.0.0-rc.1 é menor que 1.0.0. Quando ambas são pré-lançamentos, os identificadores são comparados em sequência.

Os numéricos são comparados por magnitude, os não numéricos pela ordem lexical ASCII, e um identificador numérico sempre tem precedência menor que um não numérico. Se todos os identificadores compartilhados forem iguais, a versão com mais identificadores terá precedência maior. Essas regras reproduzem a progressão padrão de alpha para beta e candidatos a lançamento sem atribuir significado especial a palavras específicas.

Metadados após o sinal de adição são validados, mas propositalmente excluídos da precedência. Assim, 1.0.0+linux e 1.0.0+windows são equivalentes apesar de diferentes.

Use a comparação rigorosa com segurança na automação

Um resultado determinístico pode servir como um pequeno e confiável ponto de decisão em sistemas maiores. Um pipeline de lançamento pode exigir que a versão proposta seja superior à implantada. Um atualizador pode decidir se um manifesto baixado representa atualização, reversão ou compilação equivalente.

Uma suíte de testes pode cobrir a sequência canônica de pré-lançamentos e rejeitar rótulos inválidos antes da publicação dos artefatos. A implementação não faz solicitações de rede, não consulta o relógio e não usa valores aleatórios; as mesmas entradas sempre produzem a mesma saída. Ela compara identificadores numéricos como sequências de dígitos, em vez de convertê-los em números JavaScript, preservando a ordem correta mesmo quando um identificador válido ultrapassa o intervalo de inteiros seguros.

O tamanho das entradas é limitado para manter o processamento previsível.