Difference de JSON Schema

Comparez deux JSON Schema et voyez exactement ce qui a change, chaque changement marque de rupture ou non.

Ancien schema

Nouveau schema

Changements

Collez deux schemas et appuyez sur Comparer.

Tout fonctionne dans votre navigateur. Rien de ce que vous collez n est envoye, et vous pouvez le verifier dans l onglet Reseau de votre navigateur.

A propos de cet outil

Ceci n est pas l outil JSON Diff: celui la compare deux documents par leur valeur. Celui ci compare deux schemas par ce qu ils accepteraient, donc chaque changement dit aussi s il est de rupture, c est a dire si un document qui satisfaisait l ancien schema pourrait maintenant echouer avec le nouveau. Une propriete ajoutee au schema n est pas de rupture en elle meme, puisque les donnees existantes ne l ont simplement pas encore; une propriete retiree n est de rupture que lorsque le nouveau schema met aussi additionalProperties a false, car c est alors seulement que porter cette propriete devient un rejet. Un champ qui devient obligatoire est de rupture, puisque les donnees existantes peuvent ne pas l avoir; un champ qui n est plus obligatoire ne l est pas. Un retrecissement de type, comme passer de number a integer, est de rupture; un elargissement, comme integer vers number, ne l est pas, et c est la seule relation de sous type que cet outil connait parmi les types primitifs de JSON Schema. Une valeur d enum retiree est de rupture, puisque les donnees qui l utilisaient echouent maintenant; une valeur ajoutee ne l est pas. Une borne resserree, un maximum plus bas ou un minimum plus haut, est de rupture; une borne assouplie ne l est pas. Un changement de pattern est toujours traite comme de rupture, puisque comparer deux expressions regulieres pour savoir laquelle accepte le plus n est pas tente, et traiter un effet inconnu comme sur serait le mauvais choix par defaut. Le sous ensemble couvert est deliberement celui que le propre Generateur de Schema du site ecrit et que le Validateur de Schema applique: un additionalProperties a valeur de schema, un items en forme de tuple, les combinateurs et $ref ne sont pas parcourus.

Comment ca marche

Collez l ancien schema dans le volet de gauche et le nouveau dans celui de droite, ou chargez l exemple.
Appuyez sur Comparer.
Lisez d abord les changements de rupture: la ligne de resume les compte a part, et les puces de filtre isolent seulement ces lignes.

Questions frequentes

Qu est ce qui rend un changement de rupture?

Si un document qui satisfaisait l ancien schema pourrait maintenant echouer avec le nouveau. Un champ qui devient obligatoire, un type qui se retrecit, une valeur d enum qui disparait, une borne qui se resserre, et une propriete qui disparait sous un schema qui ferme maintenant les proprietes supplementaires sont tous de rupture, car chacun peut rejeter des donnees qui passaient avant. Ajouter une propriete facultative, retirer une obligation, elargir un type, ajouter une valeur d enum et assouplir une borne sont tous sans rupture, car chacun accepte seulement plus qu avant, jamais moins.

Pourquoi un changement de pattern est il toujours de rupture?

Parce que savoir si une expression reguliere accepte un sur ensemble strict de ce qu accepte une autre est un probleme bien plus difficile que comparer deux nombres, et cet outil ne le tente pas. Signaler chaque changement de pattern comme de rupture est le choix sur par defaut: cela peut marquer un changement de pattern qui etait en realite inoffensif, mais cela ne manquera jamais un changement qui a casse de vraies donnees, ce qui est le sens dans lequel une verification de compatibilite doit se tromper.

Quelles parties de JSON Schema ceci ne compare t il pas?

Un additionalProperties a valeur de schema (seul true ou false est lu), un items en forme de tuple (seul un schema unique decrivant chaque element l est), les combinateurs allOf, anyOf, oneOf et not, et $ref. Ce sont les memes limites que tracent le Generateur de Schema et le Validateur de Schema du site autour de leur propre sous ensemble, donc un schema que l un ou l autre de ces outils produit ou verifie est aussi un schema que celui ci peut comparer entierement.

Difference de JSON Schema

Raccourcis clavier

Donnees locales

Fichiers ouverts recemment

Partager via un lien

Ouvrir le lien partage dans