Herramientas de desarrollo

Calculadora SemVerDistingue precedencia y coincidencia

Comprueba una restricción, compara dos versiones o calcula el siguiente número.

Calculadora SemVer

Versiones (una por línea)

La entrada se procesa en este navegador y no se envía a ningún servidor.

Resultado

Introduce datos o carga un ejemplo.

Opciones

Solo versiones SemVer 2.0.0 estrictas: sin espacios externos, prefijo v ni partes omitidas. Los números principales y los identificadores de prelanzamiento puramente numéricos no admiten ceros iniciales; los identificadores de compilación sí.

Los rangos npm admiten ^, ~, comparadores, x, guiones y ||. Un rango vacío o una rama OR vacía funciona como comodín.

Los prelanzamientos se excluyen salvo que un comparador del mismo grupo indique uno con el mismo major.minor.patch.

Los metadatos de compilación no cambian la precedencia. Las versiones equivalentes conservan su orden de entrada.

Límites de la herramienta: 1000 líneas, 100000 unidades UTF-16, 256 caracteres por versión y 4096 por rango. Los números principales y los identificadores de prelanzamiento puramente numéricos no pueden superar 9007199254740991. Este límite numérico no afecta a los identificadores de compilación.

La entrada o las opciones han cambiado. Actualiza los resultados antes de exportarlos.

La Calculadora SemVer ayuda cuando una beta más reciente no encaja en el rango de una dependencia. Separa la precedencia de las condiciones del rango antes de cambiar la restricción.

Comparar versiones no equivale a ordenar texto: 1.10.0 es posterior a 1.9.0. Las versiones semánticas también aplican reglas distintas a identificadores numéricos y alfanuméricos de prelanzamiento.

¿Por qué usar la Calculadora SemVer?

Entiende una beta excluida

La Calculadora SemVer muestra los comparadores npm expandidos junto a cada resultado. Una versión puede cumplir los límites numéricos y quedar excluida por la regla de prelanzamientos.

Las versiones estables atraviesan un rango mientras una beta sigue otro camino.

Conserva las etiquetas de compilación

1.2.3+build.1 y 1.2.3+build.7 tienen la misma precedencia. Mantienen su orden original sin convertir el número de compilación en una versión más reciente.

Dos etiquetas de compilación comparten un peldaño de una escala de versiones.

Tres comprobaciones antes de continuar

01

Separa versiones y rangos

Una versión exige tres números. Un rango admite abreviaturas como 1.2 y ^0.2.3. Un rango vacío o una rama OR vacía funciona como comodín.

02

Revisa los prelanzamientos

La opción empieza desactivada. Activarla cambia la coincidencia, no flexibiliza la sintaxis. Consulta los comparadores expandidos, sobre todo en rangos 0.x.

03

Revisa antes de reemplazar

Ejemplo y Limpiar abren una vista completa de las entradas y ajustes. Aplicar confirma el reemplazo y Deshacer restaura el estado anterior. El modo automático espera 350 ms; el manual admite Ctrl/Cmd+Enter.

Cuatro comprobaciones de versiones

Validador de rangos por lotes

Prueba una versión por línea con comparadores npm, ^, ~, comodines, rangos con guion y grupos OR.

Comparación de precedencia

Compara major, minor, patch y los identificadores de prelanzamiento. Los metadatos de compilación no determinan cuál es más reciente.

Orden estable de listas

Ordena de forma ascendente o descendente. Las líneas no válidas quedan al final con su número original; las versiones equivalentes mantienen el orden de entrada.

Siete tipos de incremento

major, minor, patch, premajor, preminor, prepatch y prerelease calculan una nueva versión sin reemplazar automáticamente la original.

Sintaxis y límites de cálculo

Versiones estrictas
Solo versiones SemVer 2.0.0 estrictas: sin espacios externos, prefijo v ni partes omitidas. Los números principales y los identificadores de prelanzamiento puramente numéricos no admiten ceros iniciales; los identificadores de compilación sí. Los metadatos de compilación no cambian la precedencia. Las versiones equivalentes conservan su orden de entrada.
Semántica de rangos npm
Los rangos npm admiten ^, ~, comparadores, x, guiones y ||. Un rango vacío o una rama OR vacía funciona como comodín. Los prelanzamientos se excluyen salvo que un comparador del mismo grupo indique uno con el mismo major.minor.patch.
Entradas limitadas
Límites de la herramienta: 1000 líneas, 100000 unidades UTF-16, 256 caracteres por versión y 4096 por rango. Los números principales y los identificadores de prelanzamiento puramente numéricos no pueden superar 9007199254740991. Este límite numérico no afecta a los identificadores de compilación.
Comportamiento del incremento
El incremento elimina los metadatos de compilación. Los nuevos contadores empiezan en 0. Un identificador vacío conserva el existente e incrementa su número.
Sin instalar paquetes
No consulta registros, instala dependencias ni modifica proyectos. Las líneas vacías son inválidas; un salto final solo termina el texto. Una coincidencia no demuestra compatibilidad de API.

Preguntas sobre la Calculadora SemVer

¿Qué diferencia hay entre ~ y ^ en package.json?

~1.2.3 admite versiones estables desde 1.2.3 hasta antes de 1.3.0; ^1.2.3 llega hasta antes de 2.0.0. ^ conserva el primer componente distinto de cero: ^0.2.3 excluye 0.3.0 y ^0.0.3 excluye 0.0.4.

¿El caret admite el último prelanzamiento?

Normalmente no. La Calculadora SemVer sigue npm: con la opción desactivada, el mismo grupo debe citar un prelanzamiento con idéntico major.minor.patch. Ser la última versión publicada no cambia el resultado.

¿Para qué sirven los metadatos de compilación?

Pueden identificar una compilación o commit, pero no alteran la precedencia. Las versiones que solo difieren después de + son equivalentes y conservan su orden al clasificarlas.

¿Puedo ordenar etiquetas de formatos distintos?

Solo se ordenan versiones SemVer estrictas. v1.2.3 o 1.10-alpine3 se conservan al final como líneas no válidas; no se convierten silenciosamente.

¿Cómo añado un sufijo alpha?

Elige un incremento de prelanzamiento y el identificador alpha. premajor convierte 1.2.3 en 2.0.0-alpha.0. Deja el identificador vacío para conservar el existente e incrementar su contador.

¿Un resultado inesperado?

Prueba la Calculadora SemVer

Usa la Calculadora SemVer con tu lista de versiones, comprueba la explicación del rango y guarda el informe actual.