Aller au contenu

Vérificateur Semver

Vérifiez, comparez et triez des versions sémantiques, et testez-les avec des plages au format npm, telles que ^1.2.0, ~2.4, >=1.0.0 <2.0.0, 1.x ou 1.2.3 - 2.3.4. Le vérificateur suit les règles de Semantic Versioning 2.0.0 pour les préversions et les métadonnées de compilation, ainsi que les mêmes règles de plages que le package semver de npm, affiche le développement d’une plage et trouve la version la plus élevée qui la satisfait.

Réinitialiser

Foire aux questions

Que fait le vérificateur ?

Il analyse chaque version saisie, indique si elle est valide selon le versionnage sémantique, trie les versions valides, indique la plus élevée et, si vous saisissez une plage, précise quelles versions la satisfont et laquelle est la plus élevée parmi elles. Avec exactement deux versions, il indique également laquelle est la plus élevée.

Que signifie ^1.2.3 ?

Le caret autorise les modifications qui ne changent pas le premier nombre non nul. ^1.2.3 signifie >=1.2.3 <2.0.0, ^0.2.3 signifie >=0.2.3 <0.3.0 et ^0.0.3 signifie uniquement 0.0.3. C’est la valeur par défaut de npm lors de l’installation d’un package.

Que signifie ~1.2.3 ?

La tilde autorise les mises à jour correctives : ~1.2.3 signifie >=1.2.3 <1.3.0. Avec uniquement une version majeure, ~1 signifie >=1.0.0 <2.0.0. Utilisez-la si vous souhaitez des corrections de bugs sans nouvelles fonctionnalités mineures.

Quelles syntaxes de plages sont prises en charge ?

Les comparateurs (<, <=, >, >=, =), les plages avec caret et tilde, les plages X telles que 1.x, 1.2.* et *, les versions partielles telles que 1.2, les plages avec trait d’union telles que 1.2.3 - 2.3.4, plusieurs comparateurs séparés par des espaces qui doivent tous correspondre, ainsi que les alternatives séparées par ||.

Comment les préversions sont-elles comparées ?

Une préversion telle que 1.0.0-beta.2 est inférieure à la version finale 1.0.0. Les identifiants de préversion sont comparés un à un : les nombres numériquement, le texte par ordre alphabétique, et un nombre est toujours inférieur à du texte ; ainsi, 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.

Pourquoi 2.0.0-beta ne satisfait-il pas ^1.2.0 ?

Selon npm, une préversion ne satisfait une plage que si l’un de ses comparateurs indique une préversion ayant les mêmes versions majeure, mineure et corrective ; les plages n’incluent donc pas accidentellement les versions instables. Activez Inclure les préversions pour qu’elles correspondent comme des versions normales ; comme dans npm, les bornes inférieures des plages partielles et avec trait d’union incluent alors aussi les préversions.

Qu’est-ce que le développement d’une plage ?

Le vérificateur affiche la plage sous la forme des comparateurs simples qu’elle représente. Par exemple, ^1.2.3 = >=1.2.3 <2.0.0-0. Le suffixe -0 signifie que la borne exclut aussi les préversions de 2.0.0, exactement comme l’écrit le package semver de npm.

Les métadonnées de compilation sont-elles comparées ?

Non. Semantic Versioning ignore les métadonnées de compilation, la partie qui suit un signe plus, lors des comparaisons ; 1.0.0+build.1 et 1.0.0+build.2 sont donc égales. Le vérificateur affiche les métadonnées, mais ne les utilise pas pour le tri ni pour les plages.

Les versions précédées de v sont-elles acceptées ?

Oui. Le v initial est ignoré : v1.2.3 est donc interprété comme 1.2.3, comme le fait npm. Les versions comportant moins de trois nombres, telles que 1.2, ne sont pas valides, mais fonctionnent dans les plages, où 1.2 désigne toute version 1.2.x.

Combien de versions puis-je vérifier ?

Jusqu’à 200 versions par requête, une par ligne, et une plage de 1,000 caractères maximum.

À propos de OneClick Pro

OneClick Pro est une collection gratuite de plus de 150 outils Web pour les tâches du quotidien : convertir des images et des unités, formater et valider du code, vérifier des domaines et SEO, et travailler avec du texte, des dates et des nombres. Chaque outil fonctionne sans inscription ni abonnement, et les données saisies servent uniquement à calculer le résultat et ne sont jamais stockées. Utilisez cette boîte à outils pour des tâches ponctuelles ou ajoutez à vos favoris les outils dont vous vous servez chaque jour.