{"canonical_url":"https://engineer.company/fr/glossary/contract-testing/","content_markdown":"# Tests de contrat\n\n## Ce que c'est\n\nLes tests de contrat vérifient que deux composants s'accordent sur les requêtes, réponses ou\nmessages qu'ils échangent. Un écran de suivi de colis et un service de suivi peuvent tous deux\npasser leurs tests isolés. Pourtant l'écran échoue s'il attend un champ `status` et que le\nservice envoie `state`. Un test d'interface formule ce que l'écran utilise puis vérifie que le\nservice sait le fournir.\n\nPact présente une méthode dans laquelle le consommateur échange avec un substitut contrôlé du\nfournisseur. Le test enregistre les interactions dans un contrat. Le fournisseur vérifie ensuite\nce contrat en exécutant sa propre implémentation dans des conditions précises. Lors d'un échange\nde messages, la vérification porte sur le message produit et consommé. Les équipes peuvent\ntravailler et livrer à des rythmes différents, pourvu que les preuves concernent les versions\nqu'elles utiliseront ensemble.\n\nLe terme s'emploie aussi pour la vérification d'un fournisseur par rapport à sa documentation\npubliée, par exemple une description OpenAPI. Cette méthode sert quand la spécification écrite\nest l'accord partagé. Elle peut définir les champs, les codes d'état et les valeurs permises. Les\nexemples établis par le consommateur indiquent quelles combinaisons un appelant exploite et sur\nquelles hypothèses il s'appuie. Les deux méthodes peuvent coexister. Un parcours dans\nl'intégration réelle permet de vérifier ce qui dépasse l'échange, notamment le routage et la\nconfiguration.\n\n## Pourquoi c'est important\n\nUne interface dure souvent plus longtemps que le code qui l'a introduite. L'équipe du service\npeut renommer un champ et adapter ses propres tests sans modifier un appelant maintenu ailleurs.\nUne application mobile peut rester sur une ancienne version plusieurs mois. Un simple changement\nde type compte s'il détermine le texte affiché. Un contrat vérifiable rend ces dépendances\nvisibles avant publication.\n\nLorsque les mises en service ont des rythmes distincts, il faut savoir quelles versions sont\ncompatibles. Un client ancien peut comprendre peu de valeurs d'état et un service récent vouloir\najouter une étape intermédiaire. Les équipes peuvent adapter le consommateur d'abord, accepter\nles deux formes pendant la transition et retirer l'ancien comportement après avoir vérifié les\nversions dont elles dépendent. L'ordre sûr dépend des contrats, de l'usage réel et de la\npolitique de diffusion. La réussite d'une combinaison récente ne couvre pas tous les clients\nencore présents.\n\nLes contrôles doivent exprimer les véritables points d'accord. Si toute référence bien formée\nconvient, vérifions le format sans imposer la valeur exacte de l'exemple. Si un champ détermine\nun comportement visible, contrôlons son type et les valeurs comprises par le client. Un bon cas\nprotège l'accord tout en laissant le fournisseur faire évoluer les détails internes.\n\n## À quoi cela ressemble en pratique\n\nImaginons une application de suivi de colis. Elle demande un colis par sa référence. Lorsque le\ncolis existe et est en transit, l'écran attend une réponse de succès, la référence et un texte\nqu'il sait associer à une étiquette. Lorsqu'il ne trouve pas le colis, il attend une autre\nréponse et propose de revoir la référence. Chaque interaction est associée à une condition\npréalable, par exemple l'existence d'un colis en transit ou l'absence de toute référence\ncorrespondante.\n\nFaisons passer la requête par le vrai code du consommateur en utilisant le substitut contrôlé.\nVérifions l'affichage qui résulte de chaque échange. Exerçons ensuite les mêmes interactions sur\nle chemin réel de réponse du fournisseur. Créons des données déterministes pour chaque état et\nréinitialisons-les entre les essais. Si la base de données ou le transporteur est remplacé,\ngardons dans le test l'analyse de la requête, la logique du service et la construction de la\nréponse dont dépend le consommateur.\n\nRemplaçons provisoirement le champ `status` par `state` sans modifier le client. La vérification\ndevrait signaler le champ manquant et permettre d'identifier l'échange. Un champ facultatif\nignoré par le consommateur reste acceptable si l'accord le permet. Relions chaque preuve à sa\nversion. Mélanger le résultat d'un nouveau fournisseur et une copie non identifiée d'un ancien\ncontrat empêche de savoir ce qui a été mis à l'épreuve.\n\nNotre [note sur l'ouverture d'une application dans les portefeuilles mobiles\nSolana](/fr/notes/solana-mobile-wallet-deeplinks/) montre des intégrations qui attendent chacune\nun chemin de lien et un encodage distincts. Elle expose ces différences et propose des essais sur\nappareil. Un test de la forme des liens générés pourrait préserver ces accords. Un essai sur un\nvéritable appareil permet de voir si le navigateur transmet le lien à l'application installée et\nsi le parcours aboutit. Les deux observations ne couvrent pas la même chose.\n\n## Où les problèmes surviennent\n\nUn contrat se rigidifie si chaque octet doit correspondre à un exemple enregistré. Le fournisseur\npeut être libre d'ajouter un champ ignoré ou de reformater un message auxiliaire. Rendons un\nchamp obligatoire lorsqu'un appelant l'utilise ou lorsque la spécification publique l'exige.\nFixons l'ordre, les unités et les mots exacts aux endroits où l'accord en dépend.\n\nUn test perd aussi sa force s'il contourne la limite réelle. Vérifier un objet JSON écrit à la\nmain peut laisser le sérialiseur hors du parcours. Constater que le substitut a produit le\nrésultat préparé ne montre pas que le consommateur sait le lire. Exécutons le vrai code de\nrequête ou de réponse de la partie vérifiée et notons ce que fournissent les dépendances\nremplacées.\n\nEnfin, un exemple réussi couvre peu de choses sur les données manquantes, les références\ninconnues ou les anciennes versions. Recensons les erreurs traitées par le client et les\ncompatibilités promises par le fournisseur. Gardons des essais d'intégration qui exercent la\nconfiguration et le routage. Le contrat apporte une preuve ciblée et assez rapide pour\naccompagner chaque évolution pertinente.\n\n## Pour aller plus loin\n\n- [Pact et la définition des tests de contrat](https://docs.pact.io/#what-is-contract-testing)\n- [Vérification du consommateur et du fournisseur dans\n  Pact](https://docs.pact.io/getting_started/how_pact_works)\n- [Documentation de Pact sur les états du\n  fournisseur](https://docs.pact.io/getting_started/provider_states)\n- [Spécification OpenAPI pour les interfaces HTTP](https://spec.openapis.org/oas/latest.html)\n\n\u003chttps://engineer.company/fr/glossary/contract-testing/\u003e\n","date_modified":"2026-11-19T19:18:49Z","description":"Vérifier un accord entre composants à partir d’un suivi de colis, d’états du fournisseur et de versions livrées à des rythmes différents.","formats":{"gemtext":"https://engineer.company/fr/glossary/contract-testing/index.gmi","gopher":"https://engineer.company/fr/glossary/contract-testing/gophermap","html":"https://engineer.company/fr/glossary/contract-testing/","json":"https://engineer.company/fr/glossary/contract-testing/index.json","markdown":"https://engineer.company/fr/glossary/contract-testing/index.md","pdf":"https://engineer.company/fr/glossary/contract-testing/index.pdf"},"kind":"page","language":"fr","title":"Que sont les tests de contrat ?","url":"https://engineer.company/fr/glossary/contract-testing/","version":1}