# Kontrakttest

## Hvad det er

En kontrakttest kontrollerer, at to komponenter er enige om de anmodninger, svar eller beskeder,
de udveksler. En side til pakkesporing og tjenesten bag den kan bestå hver sin test. Siden fejler
alligevel, hvis den forventer feltet `status`, og tjenesten sender `state`. En test af
grænsefladen udtrykker, hvad siden bruger, og efterprøver, at den anden side kan levere det.

Pact beskriver en metode, hvor forbrugeren kører mod en kontrolleret erstatning for udbyderen.
Testen gemmer udvekslingerne i en kontrakt. Udbyderen efterprøver den i sin egen implementering
under bestemte forudsætninger. For beskeder handler beviset om, hvad den ene side producerer og
den anden læser. De to sider kan udvikle og udgive i forskelligt tempo, når beviserne handler om
de versioner, som skal virke sammen.

Klienten kan også have en aftalt adfærd ved en ukendt værdi. Hvis en manglende status kan vises
som »Ukendt status«, behøver en ny værdi ikke ødelægge hele siden. Det kræver en
forretningsbeslutning og et testtilfælde, der dokumenterer, hvad klienten gør.

Kontrakttest kan også betyde, at en udbyder kontrolleres mod en offentlig grænsefladebeskrivelse
som OpenAPI. Det passer, når den skrevne specifikation er selve aftalen. Den kan angive felter,
statuskoder og tilladte værdier. Eksempler fra forbrugeren kan desuden vise, hvilke kombinationer
et bestemt kald bruger. Metoderne kan bruges sammen. Et testforløb gennem den virkelige
integration kan afdække forhold uden for den enkelte udveksling, som rute, adgang og opsætning.

## Hvorfor det betyder noget

En grænseflade lever ofte længere end den kode, som først leverede den. Tjenestens hold kan
omdøbe et felt og opdatere egne tests uden at ændre en klient i et andet projekt. En mobilapp kan
fortsat køre en gammel version i flere måneder. Selv ændring af typen på et felt betyder noget,
når feltet vælger en tekst, brugeren ser. Med en efterprøvbar kontrakt kan holdene se den
afhængighed før frigivelse.

Uafhængige udgivelser øger værdien af viden om kompatibilitet. En ældre klient forstår måske kun
få statustyper, mens udbyderen har brug for en ny mellemtilstand. Holdene kan forberede
forbrugeren først, bevare begge former gennem overgangen og fjerne den gamle, når ingen
understøttet version bruger den. En sikker rækkefølge afhænger af registrerede aftaler, den
virkelige brug og udgivelsespolitikken. Et vellykket forsøg med de to nyeste udgaver dækker ikke
automatisk de tidligere.

Testen bør beskrive det, der betyder noget for aftalen. Er enhver gyldig reference acceptabel, så
kontrollér formen og undlad at låse en bestemt eksempelværdi. Vælger et felt en synlig status, så
kontrollér typen og de værdier, klienten forstår. Et præcist eksempel beskytter aftalen uden at
fryse udbyderens interne løsning.

## Sådan ser det ud i praksis

En tænkt app sporer pakker ved hjælp af en reference. Når pakken findes og er på vej, forventer
siden et vellykket svar, en reference og en tekstværdi, den kan omsætte til en status. Når pakken
er ukendt, forventer den et andet svar og giver mulighed for at kontrollere referencen. Hver
udveksling har en forudsætning, for eksempel at pakken er på vej, eller at referencen ikke
findes.

Kør forbrugerens virkelige anmodningskode mod den kontrollerede erstatning. Kontrollér resultatet
i appen. Afspil de samme udvekslinger på udbyderens virkelige svarvej. Opret forudsigelige
testdata for den aftalte tilstand, og nulstil dem mellem forsøg. Erstatter testen en database
eller transportørens system, så behold den anmodningsbehandling, programlogik og dannelse af
svaret, som forbrugeren afhænger af.

Omdøb midlertidigt `status` til `state` uden at ændre klienten. Kontrollen skal angive det
manglende felt og pege på den relevante udveksling. Et ekstra valgfrit felt, som forbrugeren
ignorerer, kan være i orden, hvis kontrakten tillader det. Knyt kontrollerne til de præcise
versioner. En blanding af nye resultater og gamle ukendte eksempler gør det svært at se, hvilken
kombination der blev efterprøvet.

Vores [note om at åbne en app i mobile
Solana-tegnebøger](/da/notes/solana-mobile-wallet-deeplinks/) viser integrationer, der forventer
forskellige adresser og kodning af parametre. Noten beskriver forskellene og forsøg på en enhed.
En test af de dannede links kan fastholde deres forventede form. Et forsøg på en rigtig enhed kan
vise, om browseren sender linket videre til den installerede app, og om forløbet lykkes. Det er
to forskellige observationer.

## Hvor det går galt

En kontrakt kan blive for stiv, hvis hver byte i svaret skal være som i et gemt eksempel. En
udbyder kan have frihed til at tilføje et ubrugt felt eller ændre formen på en besked. Kræv fast
rækkefølge, enhed eller ordlyd, når klienten afhænger af det, eller den offentlige specifikation
kræver det.

En test mister værdi, hvis den går uden om grænsen. Et håndskrevet JSON-objekt kan virke uden at
køre koden, der normalt danner svaret. En erstatning kan levere et aftalt eksempel, uden at
klienten kan læse det gennem den normale vej. Kør den rigtige kode for den side, der efterprøves,
og dokumentér de afhængigheder, der er erstattet.

Et enkelt lykkeligt forløb siger endelig lidt om manglende data, ukendte referencer eller gamle
versioner. Find de fejltilstande, klienten håndterer, og de versioner, udbyderen skal
understøtte. Behold integrationstest af opsætning og ruter. Kontrakten giver så et mindre,
hurtigt bevis, der kan anvendes ved hver relevant ændring.

## Læs mere

- [Pacts beskrivelse af kontrakttest](https://docs.pact.io/#what-is-contract-testing)
- [Sådan efterprøver Pact forbrugerens og udbyderens
  kontrakt](https://docs.pact.io/getting_started/how_pact_works)
- [Dokumentation af udbydertilstande i
  Pact](https://docs.pact.io/getting_started/provider_states)
- [OpenAPI-specifikationen for HTTP-grænseflader](https://spec.openapis.org/oas/latest.html)

<https://engineer.company/da/glossary/contract-testing/>
