{"canonical_url":"https://engineer.company/de/glossary/contract-testing/","content_markdown":"# Vertragstest\n\n## Was es ist\n\nEin Vertragstest prüft, ob sich zwei Komponenten über die ausgetauschten Anfragen, Antworten oder\nNachrichten einig sind. Eine Anwendung zur Paketverfolgung und ihr Dienst können isoliert\nfehlerfrei arbeiten. Die Oberfläche scheitert dennoch, wenn sie ein Feld namens `status` erwartet\nund der Dienst `state` sendet. Eine Prüfung der Schnittstelle beschreibt, was die Oberfläche\nverwendet, und überprüft, ob der Dienst es liefern kann.\n\nPact beschreibt einen Ansatz, bei dem der Verbraucher gegen einen kontrollierten Ersatz des\nAnbieters ausgeführt wird. Der Test zeichnet Interaktionen in einem Vertrag auf. Der Anbieter\nprüft den Vertrag mit seiner tatsächlichen Implementierung unter den festgelegten Bedingungen.\nBei Nachrichten betrifft der Nachweis die erzeugte und gelesene Nachricht. Beide Seiten können\nsich unabhängig weiterentwickeln und ausgeliefert werden, wenn der Nachweis zu den gemeinsam\neingesetzten Versionen passt.\n\nEin vorher vereinbarter Umgang mit unbekannten Angaben kann Teil des Vertrags sein. Eine Anzeige\nwie „Status nicht verfügbar“ kann für zusätzliche Werte sinnvoll sein. Ob sie ausreicht,\nentscheidet das Produkt anhand der Aufgabe des Lesers. Der Test zeigt, wie sich der konkrete\nVerbraucher in diesem Fall verhält.\n\nDer Begriff wird auch für Prüfungen eines Anbieters gegen seine veröffentlichte\nSchnittstellenbeschreibung verwendet, etwa ein OpenAPI-Dokument. Das ist sinnvoll, wenn die\nSpezifikation den gemeinsamen Vertrag darstellt. Sie kann Felder, Statuscodes und erlaubte Werte\nfestlegen. Verbrauchergetriebene Beispiele zeigen zusätzlich, welche Kombinationen ein bestimmter\nAufrufer verwendet und welche Annahmen er trifft. Beide Ansätze haben ihren Platz. Ein echter\nIntegrationsdurchlauf prüft außerdem Routing, Zugang und Konfiguration.\n\n## Warum es wichtig ist\n\nEine Schnittstelle bleibt häufig länger bestehen als die erste Implementierung. Das Dienstteam\nkann ein Feld umbenennen und seine eigenen Tests aktualisieren, ohne eine separat gepflegte\nAnwendung zu ändern. Eine mobile Anwendung kann Monate in einer älteren Version betrieben werden.\nSelbst ein anderer Typ ist wichtig, wenn damit eine sichtbare Meldung ausgewählt wird.\nÜberprüfbare Verträge zeigen solche Abhängigkeiten vor der Freigabe.\n\nBei unterschiedlichen Freigabefolgen ist das Wissen über verträgliche Versionen besonders\nwertvoll. Ein älterer Verbraucher kennt vielleicht nur wenige Statuswerte, während der neue\nDienst einen Zwischenstatus benötigt. Die Teams können zuerst den Verbraucher anpassen, während\nder Umstellung beide Formen verarbeiten und altes Verhalten erst entfernen, wenn keine abhängige\nVersion es nutzt. Die Reihenfolge hängt von Verträgen, tatsächlicher Nutzung und Freigaberegeln\nab. Eine erfolgreiche Prüfung zweier neuer Versionen deckt ältere Anwendungen nicht mit ab.\n\nTests sollten die entscheidenden Eigenschaften ausdrücken. Reicht eine formal gültige Kennung,\nprüfen Sie das Format anstelle eines festen Werts. Bestimmt ein Feld die Anzeige, sind der Typ\nund die verstandenen Werte wichtig. So schützt der Vertrag gemeinsames Verhalten und lässt\nÄnderungen am inneren Aufbau zu.\n\n## Wie es in der Praxis aussieht\n\nEin ausgedachtes Beispiel ist eine Anwendung zur Paketverfolgung. Sie fragt ein Paket mit seiner\nKennung ab. Existiert es und ist unterwegs, erwartet die Oberfläche eine erfolgreiche Antwort,\ndie Kennung und einen Textwert für die passende Anzeige. Bei einem unbekannten Paket erwartet sie\neine andere Antwort und schlägt vor, die Kennung zu prüfen. Zu jeder Interaktion gehört ein\nAusgangszustand, etwa ein Paket im Transport oder kein Paket mit der angegebenen Kennung.\n\nLassen Sie den Verbraucher seine wirkliche Anfrage an den kontrollierten Ersatz senden. Prüfen\nSie jeweils das angezeigte Ergebnis. Führen Sie dann dieselben Interaktionen auf dem wirklichen\nAntwortweg des Anbieters aus. Bereiten Sie reproduzierbare Daten für den jeweiligen Zustand vor\nund setzen Sie sie zwischen Versuchen zurück. Ersetzt der Test eine Datenbank oder einen\nFrachtanbieter, sollen die relevante Verarbeitung der Anfrage, die Dienstlogik und die Erzeugung\nder Antwort weiterhin laufen.\n\nÄndern Sie zur Probe das Feld `status` in `state`, ohne den Verbraucher zu ändern. Die\nVerifikation sollte das fehlende Feld und die betroffene Interaktion melden. Ein zusätzliches\noptionales Feld kann zulässig sein, wenn es der Verbraucher ignoriert und der Vertrag es erlaubt.\nOrdnen Sie jede Prüfung ihren Versionen zu. Vermischte Ergebnisse aus neuem Dienst und unklarer\nVertragsfassung erschweren die Aussage, welche Kombination überprüft wurde.\n\nUnsere [Notiz zum Öffnen einer Anwendung in mobilen\nSolana-Wallets](/de/notes/solana-mobile-wallet-deeplinks/) zeigt Schnittstellen mit\nunterschiedlichen Linkpfaden und Codierungen von Parametern. Die Notiz beschreibt diese\nUnterschiede und Prüfungen auf Geräten. Eine Prüfung erzeugter Links könnte die erwartete Form je\nWallet absichern. Ein Durchlauf mit einem echten Gerät kann zeigen, ob der Browser den Link an\ndie installierte App übergibt und der Vorgang abgeschlossen wird. Das sind unterschiedliche\nFragen.\n\n## Wo es schiefgeht\n\nVerträge können zu starr werden, wenn jedes Byte einer Antwort einem gespeicherten Beispiel\nentsprechen soll. Ein Anbieter kann berechtigt sein, ein ungenutztes Feld hinzuzufügen oder eine\nZusatzmeldung anders zu formatieren. Verlangen Sie genaue Werte, Reihenfolge oder Einheiten dort,\nwo Verbraucher oder Spezifikation sich darauf verlassen.\n\nEin Test verliert auch an Wert, wenn er die Grenze umgeht. Ein von Hand geschriebenes JSON-Objekt\nkann den Code zur Erzeugung der Antwort auslassen. Ein Ersatz kann die vorbereitete Probe\nzurückgeben, obwohl der Verbraucher sie im normalen Ablauf falsch liest. Führen Sie den echten\nAnfrage- oder Antwortcode der geprüften Seite aus und kennzeichnen Sie ersetzte Abhängigkeiten.\n\nEin gelungener Normalfall sagt zuletzt wenig über fehlende Daten, unbekannte Kennungen und ältere\nVersionen. Berücksichtigen Sie bekannte Fehlerwege und zugesicherte Kompatibilität. Behalten Sie\nIntegrationstests für Routing und Konfiguration. Ein präziser Vertrag gibt beiden Teams eine\ngezielte, schnelle Prüfung für jede betroffene Änderung.\n\n## Weiterführende Lektüre\n\n- [Pact-Dokumentation zum Begriff Vertragstest](https://docs.pact.io/#what-is-contract-testing)\n- [Verifikation von Verbraucher und Anbieter mit\n  Pact](https://docs.pact.io/getting_started/how_pact_works)\n- [Dokumentation zu Anbieterzuständen in\n  Pact](https://docs.pact.io/getting_started/provider_states)\n- [OpenAPI-Spezifikation für HTTP-Schnittstellen](https://spec.openapis.org/oas/latest.html)\n\n\u003chttps://engineer.company/de/glossary/contract-testing/\u003e\n","date_modified":"2026-11-19T19:18:49Z","description":"Wie Vertragstests Schnittstellen zwischen Komponenten prüfen, mit einem Beispiel zur Paketverfolgung und Hinweisen zu getrennten Freigaben.","formats":{"gemtext":"https://engineer.company/de/glossary/contract-testing/index.gmi","gopher":"https://engineer.company/de/glossary/contract-testing/gophermap","html":"https://engineer.company/de/glossary/contract-testing/","json":"https://engineer.company/de/glossary/contract-testing/index.json","markdown":"https://engineer.company/de/glossary/contract-testing/index.md","pdf":"https://engineer.company/de/glossary/contract-testing/index.pdf"},"kind":"page","language":"de","title":"Was ist ein Vertragstest?","url":"https://engineer.company/de/glossary/contract-testing/","version":1}