{"canonical_url":"https://engineer.company/nb/glossary/contract-testing/","content_markdown":"# Kontraktstesting\n\n## Hva det er\n\nKontraktstesting undersøker om to komponenter er enige om forespørslene, svarene eller meldingene\nde utveksler. En skjerm for pakkesporing og tjenesten bak skjermen kan virke hver for seg.\nSkjermen feiler likevel hvis den leter etter feltet `status` og tjenesten sender `state`. En test\nkan beskrive det skjermen bruker og kontrollere at tjenesten kan levere det.\n\nPact beskriver en tilnærming der konsumenten kjører mot en kontrollert erstatning for\nleverandøren. Testen registrerer samhandlingen i en kontrakt. Leverandøren kontrollerer den så\ngjennom sin egen implementasjon under avtalte forutsetninger. For meldinger handler tilsvarende\nbevis om meldingen som blir laget og lest. De to sidene kan arbeide og gi ut nye versjoner\nuavhengig hvis bevisene gjelder versjonene som skal brukes sammen.\n\nNoen bruker samme begrep om kontroll av en leverandør mot den publiserte grensesnittbeskrivelsen,\nfor eksempel et OpenAPI-dokument. Det er nyttig når spesifikasjonen er den felles avtalen. Den\nkan angi felter, statuskoder og tillatte verdier. Konsumentdrevne eksempler viser dessuten hvilke\nkombinasjoner en bestemt klient trenger. Begge metodene kan brukes samtidig. Et forsøk gjennom\nden ekte integrasjonen kan undersøke ruting, tilgang og oppsett i tillegg.\n\n## Hvorfor det er viktig\n\nEt grensesnitt lever ofte lenger enn koden som innførte det. Tjenestens team kan gi et felt nytt\nnavn og endre egne tester uten å oppdatere klienten i et annet prosjekt. En mobilapp kan være i\nbruk i en eldre versjon i flere måneder. Selv en liten typeendring kan endre teksten som vises\ntil brukeren. En kontraktstest gjør avhengigheten synlig før utgivelsen.\n\nUavhengige utgivelser øker behovet for kunnskap om kompatibilitet. En eldre klient kan forstå\nbare noen få statuser, mens en ny tjeneste trenger en mellomstatus. Teamene kan oppdatere\nklienten først, godta begge former gjennom overgangen og fjerne den gamle når ingen versjon som\nstøttes, bruker den. En trygg rekkefølge avhenger av kontraktene, faktisk bruk og\nutgivelsesreglene. En prøve med de to nyeste utgavene sier ikke hva som skjer med eldre klienter.\n\nTestene bør uttrykke de vesentlige punktene. Dersom enhver gyldig referanse fungerer, sjekk\nformatet uten å kreve én bestemt verdi. Hvis et felt bestemmer hva brukeren ser, kontroller typen\nog verdiene klienten håndterer. Eksempler kan også vise en avtalt reaksjon på en ukjent status.\nHvis klienten kan vise «status ikke tilgjengelig» uten å miste resten av siden, bør testen vise\nhva det betyr. Beslutningen hører til produktet.\n\n## Slik ser det ut i praksis\n\nTenk deg en app som sporer pakker. Den spør etter en pakke med en referanse. Når pakken finnes og\ner underveis, forventer appen et svar som angir suksess, riktig referanse og en tekstverdi den\nkan omsette til en status. Når pakken er ukjent, forventer den et annet svar og gir brukeren en\nmåte å undersøke referansen på. Hvert eksempel har en bestemt situasjon som må opprettes før\nforespørselen kjøres.\n\nBruk klientens virkelige forespørselskode mot erstatningen og kontroller det synlige resultatet.\nKjør deretter den samme forespørselen gjennom leverandørens virkelige svarvei. Bruk kjente\ntestdata for hver situasjon, og nullstill dem mellom forsøk. Hvis testen erstatter databasen\neller en ekstern transportør, skal parsing, tjenestens behandling og produksjon av svaret\nfortsatt kjøres.\n\nBytt feltet `status` til `state` midlertidig uten å endre klienten. Kontrollen bør gjenkjenne det\nmanglende feltet og peke på den aktuelle utvekslingen. Et nytt felt som konsumenten ikke bruker,\nkan fortsatt være tillatt. Knytt kontrollen til de nøyaktige versjonene. Et resultat fra én\ntjeneste og en uidentifisert kopi av en gammel kontrakt viser ingen sikkert testet kombinasjon.\n\n[Vårt notat om å åpne programmer i mobile\nSolana-lommebøker](/nb/notes/solana-mobile-wallet-deeplinks/) beskriver integrasjoner med ulike\nlenkestier og koding av parametere. Notatet dokumenterer ulikhetene og tester man kan gjøre på en\nenhet. En test av genererte lenker kan beskytte formen hver lommebok forventer. Et forsøk på en\nvirkelig enhet viser om nettleseren overlater lenken til appen og om brukerforløpet lykkes. Det\ner to forskjellige observasjoner.\n\n## Hvor det går galt\n\nEn kontrakt kan bli for streng hvis den krever samme bytefølge som ett lagret eksempel. Tjenesten\nkan få lov til å legge til et ubrukt felt eller endre formateringen av et frittstående svar. Krev\nbestemt rekkefølge, enhet eller ordlyd når klienten bruker det eller den offentlige\nspesifikasjonen krever det.\n\nEn test mister verdi når den går utenom det virkelige grensesnittet. En håndskrevet JSON-fil kan\nla koden som lager svaret, stå uprøvd. En erstatning kan returnere det avtalte eksempelet selv om\nklienten ikke tolker det i normal bruk. Kjør forespørsels- eller svarkoden for siden som testes,\nog noter hvilke avhengigheter som er erstattet.\n\nFor en eldre klient kan det være for sent å legge inn ny håndtering etter at tjenesten er rullet\nut. Avklar hvilke klientversjoner som faktisk er i bruk, og behold prøver for dem så lenge\navtalen skal støttes. Da kan teamene diskutere overgangen med samme bevisgrunnlag.\n\nEtt vellykket forløp sier til sist lite om manglende data, ukjente referanser og eldre versjoner.\nFinn feilene klienten kan håndtere og versjonene leverandøren faktisk støtter. Behold\nintegrasjonstester av ruting og oppsett. Kontrakten gir et avgrenset, raskere bevis som teamene\nkan bruke ved hver relevant endring.\n\n## Les mer\n\n- [Pact-dokumentasjonen om hva kontraktstesting\n  er](https://docs.pact.io/#what-is-contract-testing)\n- [Slik kontrollerer Pact konsumenten og\n  leverandøren](https://docs.pact.io/getting_started/how_pact_works)\n- [Pact-dokumentasjonen om tilstander hos\n  leverandøren](https://docs.pact.io/getting_started/provider_states)\n- [OpenAPI-spesifikasjonen for HTTP-grensesnitt](https://spec.openapis.org/oas/latest.html)\n\n\u003chttps://engineer.company/nb/glossary/contract-testing/\u003e\n","date_modified":"2026-11-19T19:18:49Z","description":"Slik prøver kontraktstesting avtalte grensesnitt i pakkesporing, med tilstander hos leverandøren og verifisering av ulike versjoner.","formats":{"gemtext":"https://engineer.company/nb/glossary/contract-testing/index.gmi","gopher":"https://engineer.company/nb/glossary/contract-testing/gophermap","html":"https://engineer.company/nb/glossary/contract-testing/","json":"https://engineer.company/nb/glossary/contract-testing/index.json","markdown":"https://engineer.company/nb/glossary/contract-testing/index.md","pdf":"https://engineer.company/nb/glossary/contract-testing/index.pdf"},"kind":"page","language":"nb","title":"Hva er kontraktstesting?","url":"https://engineer.company/nb/glossary/contract-testing/","version":1}