Accueil › Node.js › Ce changement casse-t-il un client
Ce changement casse-t-il un client
Exercice de la série « Concevoir une API REST »avance
Le besoin. Avant de déployer, vous comparez le schéma de la version publiée et celui que vous vous apprêtez à publier. La question n'est pas « qu'est-ce qui a changé » mais « qu'est-ce qui casse un client qui fonctionne aujourd'hui ».
Ce qu'on vous demande. Écrivez comparer(v1, v2). Chaque schéma porte
reponse — un objet associant un champ à son type — et requete — un
objet associant un paramètre à { type, obligatoire }. Renvoyez
{ compatible, differences }, où chaque différence est
{ ou, champ, nature, compatible } et où differences est triée par
ou puis par champ.
| Différence | nature |
Compatible |
|---|---|---|
| champ de réponse ajouté | champ_ajoute |
oui |
| champ de réponse retiré | champ_retire |
non |
| type d'un champ de réponse modifié | type_modifie |
non |
| paramètre optionnel ajouté | parametre_ajoute |
oui |
| paramètre obligatoire ajouté | parametre_obligatoire_ajoute |
non |
| paramètre devenu obligatoire | parametre_resserre |
non |
| paramètre devenu optionnel | parametre_assoupli |
oui |
| paramètre retiré | parametre_retire |
non |
ou vaut "reponse" ou "requete". compatible est true si aucune
différence n'est incompatible.
Le piège. Le changement de type. Passer un montant de nombre à chaîne
ne lève aucune erreur en JavaScript : montant * 2 continue de marcher,
montant + 1 produit "101". La panne n'apparaît pas là où le changement
a eu lieu, et un outil qui classerait ce changement comme un simple
« champ modifié » laisserait déployer un calcul faux.
Cas de test
[{"reponse":{"id":"string","montant":"number"},"requete":{}},{"reponse":{"id":"string","montant":"number","devise":"string"},"requete":{}}][{"reponse":{"id":"string","montant":"number"},"requete":{}},{"reponse":{"id":"string","montant":"string"},"requete":{}}][{"reponse":{"id":"string","cree_le":"string"},"requete":{}},{"reponse":{"id":"string"},"requete":{}}][{"reponse":{"id":"string"},"requete":{"page":{"type":"number","obligatoire":false}}},{"reponse":{"id":"string"},"requete":{"page":{"type":"number","obligatoire":true}}}][{"reponse":{"id":"string"},"requete":{}},{"reponse":{"id":"string"},"requete":{"taille":{"type":"number","obligatoire":false},"client":{"type":"string","obligatoire":true}}}][{"reponse":{"id":"string"},"requete":{"tri":{"type":"string","obligatoire":true}}},{"reponse":{"id":"string"},"requete":{"tri":{"type":"string","obligatoire":false}}}]
Votre code s'exécute réellement dans le navigateur, et la correction compare son résultat à celui d'une solution de référence.