Comment utiliser : Calculateur SemVer
- Comparer : saisissez deux versions pour voir laquelle est la plus récente et pourquoi (prerelease et métadonnées de build incluses).
- Incrémenter : saisissez la version actuelle puis cliquez sur le type de changement pour obtenir la version suivante, copiée automatiquement.
- Tester une plage : saisissez une plage npm comme
^1.2.0,~1.2,1.xou>=1.2 <2, puis une liste de versions. - Lisez l’explication en français simple et découvrez quelles versions satisfont la plage.
Versionnement sémantique : MAJOR.MINOR.PATCH
| Partie | Augmenter quand… | Exemple |
|---|---|---|
| MAJOR | vous introduisez des changements incompatibles | 1.4.2 → 2.0.0 |
| MINOR | vous ajoutez des fonctionnalités, compatibles avec les versions précédentes | 1.4.2 → 1.5.0 |
| PATCH | vous corrigez des bugs, compatibles avec les versions précédentes | 1.4.2 → 1.4.3 |
| Prerelease | vous publiez une version de test | 2.0.0-beta.1 |
| Métadonnées de build | vous étiquetez un build (ignoré pour l’ordre de priorité) | 1.4.2+sha.5114f85 |
Aide-mémoire des plages npm
| Plage | Signifie | Autorise |
|---|---|---|
^1.2.3 | Compatible avec 1.2.3 | >=1.2.3 <2.0.0 |
^0.2.3 | Pour 0.x, le mineur joue le rôle de « majeur » | >=0.2.3 <0.3.0 |
~1.2.3 | Mises à jour de patch uniquement | >=1.2.3 <1.3.0 |
1.x / 1 | Toute version 1.y.z | >=1.0.0 <2.0.0 |
1.2.3 - 2.3 | Plage avec tiret | >=1.2.3 <2.4.0 |
>=1.2 <1.5 || 2.x | L’un ou l’autre ensemble | 1.2.0–1.4.x ou 2.x |
Les prereleases ne correspondent à une plage que si un comparateur du même ensemble possède une prerelease sur le même major.minor.patch : ainsi ^1.2.0 ne correspond pas à 1.3.0-beta.1, mais ^1.3.0-beta.0 oui. Cela évite d’installer par erreur des versions instables.
Les plages se trouvent dans votre package.json. Pour déterminer la prochaine version à partir de vos commits, utilisez le Générateur de changelog ; pour étiqueter la version, le Générateur de commandes Git.
Aussi recherché comme : tester plage semver, plage de version npm, caret vs tilde, versionnement sémantique, incrémenter version, comparer versions, semver prerelease, vérificateur semver.
Outils complémentaires : Calculateur SemVer
- Générateur de workflows GitHub Actions — Choisissez votre pile, vos déclencheurs et vos étapes, puis obtenez un script commenté .github/workflows/ci.yml — installation, mise en cache, analyse syntaxique, test, compilation, une matrice de versions et, en option, un déploiement vers GitHub Pages, Vercel ou un registre de conteneurs.
- Convertisseur de base numérique — Saisissez un nombre dans n’importe quelle base et découvrez-le instantanément dans toutes les autres.
- Vérificateur de différences — Collez une version originale et une version modifiée pour comparer côte à côte les lignes ajoutées, supprimées et modifiées — les mots exacts qui ont été modifiés étant mis en évidence dans chaque ligne.
- Validateur YAML — Collez un fichier Docker Compose, un manifeste Kubernetes, un workflow GitHub Actions ou tout autre YAML pour localiser les erreurs, repérer les pièges courants et obtenir une version proprement formatée.
Questions fréquentes
Puis-je utiliser cet outil comme testeur semver ?
Oui. Saisissez une plage comme ^1.2.0, ~2.3 ou >=1.0 <2.0 ainsi qu’une liste de versions : chaque version est marquée comme correspondante ou non, avec une explication en français simple de la plage.
Quelle est la différence entre ^ et ~ dans package.json ?
^1.2.3 autorise les mises à jour mineures et de patch (jusqu’à 2.0.0 exclu). ~1.2.3 n’autorise que les mises à jour de patch (jusqu’à 1.3.0 exclu). Pour les versions 0.x, ^ est plus strict : ^0.2.3 n’autorise que 0.2.x.La version 1.10.0 est-elle plus récente que 1.9.0 ?
Oui. Chaque partie est comparée comme un nombre et non comme du texte, donc 10 > 9.
Comment comparer les versions prerelease ?
Une prerelease est inférieure à la version normale : 2.0.0-beta.1 < 2.0.0. Les identifiants de prerelease sont comparés partie par partie : les nombres numériquement, le texte alphabétiquement, et les nombres sont classés avant le texte.
Les métadonnées de build (+build) ont-elles une importance ?
Non, elles sont ignorées lors de la comparaison : 1.0.0+20261026 et 1.0.0+abc ont la même priorité.
Puis-je installer Calculateur SemVer en tant qu’application web et l’utiliser hors ligne ?
Oui. Calculateur SemVer est une application web installable (PWA) : elle s’installe depuis votre navigateur, sans passer par une boutique d’applications. Cliquez sur « Installer l’application » en haut de cette page dans Chrome ou Edge (Windows, macOS, Linux, ChromeOS) ; sur Android, utilisez « Partager » → « Ajouter à l’écran d’accueil » sur iPhone et iPad ; ou « Fichier » → « Ajouter au Dock » dans Safari 17+ sur Mac. L’application s’ouvre alors dans sa propre fenêtre avec sa propre icône, et comme elle s’exécute entièrement dans votre navigateur, elle continue de fonctionner hors ligne. Firefox sur ordinateur de bureau ne permet pas d’installer d’applications web. Comment fonctionne l’installation.