{"canonical_url":"https://engineer.company/nb/glossary/unit-test/","content_markdown":"# Enhetstest\n\n## Hva det er\n\nEn enhetstest er en liten, automatisk kontroll av én kodebit for seg selv: den\nkaller en funksjon, en klasse eller en liten modul med utvalgte inndata og\nsjekker at det som kommer tilbake, er det som skal komme tilbake. Slike tester\nutformes vanligvis slik at de kjører i samme prosess som koden de tester,\nblir raskt ferdige og ikke trenger nettverk, database eller nettleser. Det er\nnyttige valg når det gjelder ressurser og isolasjon, ikke garantier som følger av testens\nsnevre omfang alene. Testen kalles også en unit test, og arbeidet med å skrive\ndem kalles enhetstesting. Prosjektets samling av dem er dets enhetstestsuite.\n\nHva som teller som en enhet, er mindre avklart enn navnet tilsier. I kapittelet\nom unit testing i _Software Engineering at Google_ bruker Erik Kuefler\nbetegnelsen om tester med relativt snevert omfang, for eksempel én klasse eller\nmetode, og legger til at en enhet kan være så liten som én funksjon eller så vid\nsom en samling beslektede pakker. Grensen som er nyttig i praksis, går der andre\nkaller koden: en enhet er det som tilbyr et grensesnitt noen utenfor er\navhengige av, og testene bruker grensesnittet slik kallerne gjør.\n\nDe moderne rammeverkene har felles opphav. Kent Becks artikkel _Simple Smalltalk\nTesting: With Patterns_ beskrev et lite rammeverk bygd av fixtures,\ntesttilfeller, kontroller og suiter, og anbefalte at utviklerne skrev sine egne\nenhetstester, én per klasse. Pythons `unittest` skriver i dokumentasjonen at det\nopprinnelig var inspirert av JUnit, og har de samme fire begrepene: en test\nfixture (forberedelsen en test trenger, og oppryddingen etterpå), et\ntesttilfelle (den enkelte testenheten), en testsuite og en testkjører. Begge\ntrekker et skille som er verdt å holde fast ved: en failure er en kontroll som\nfikk feil svar, mens en error er noe testen ikke hadde regnet med i det hele\ntatt, for eksempel et unntak som kastes dypt inne i koden.\n\nEnhetstester ligger i den smale enden av en skala. I kapittelet om testing i\nsamme bok sorterer Adam Bender tester etter omfang: smale tester kalles gjerne\nunit tests, mellomstore tester som dekker noen få komponenter sammen, er\nintegrasjonstester, og store tester som driver hele systemet, er\nende-til-ende-tester.\n\n## Hvorfor det er viktig\n\nHastighet er den første grunnen. En liten, isolert enhetstest kjører i samme prosess som koden\nden tester, så en utvikler kan kjøre tusenvis av dem på en vanlig arbeidsdag, og\nen feil viser seg mens endringen som forårsaket den, fortsatt står på skjermen.\nGoogles retningslinjer er tydelige på hva de tillater: en liten test får ikke\nsove, gjøre I/O eller røre nettverket eller disken. Begrensningene gjør det lettere å lage raske tester med\nrepeterbare resultater, og et team lærer seg å stole på en suite som gir samme svar\nhver gang.\n\nDen andre er feilsøking. Når en smal test feiler, ligger feilen i en liten\nkodebit, som regel den som nettopp ble endret. Når en test som driver hele\nsystemet, feiler, kan feilen ligge hvor som helst mellom nettleseren og\ndatabasen. Derfor beskriver _Software Engineering at Google_ en pyramide som en\ngrov rettesnor: omtrent 80 % smale tester, 15 % integrasjonstester og 5 %\nende-til-ende-tester.\n\nDen tredje er endring. En suite som sjekker atferd gjennom et offentlig\ngrensesnitt, gjør det mulig å bygge om koden bak grensesnittet uten frykt:\nbestår testene fortsatt, får kallerne fortsatt det de skal ha. Kueflers ideal er\nen test som aldri må endres med mindre kravene endres, slik at en ren\nrefaktorering ikke berører en eneste test.\n\nEnhetstester dokumenterer også. En test som er oppkalt etter en atferd, med\nenkle inndata og et forventet resultat skrevet helt ut, viser neste leser\nhvordan koden skal kalles og hva den lover, og i motsetning til en kommentar\nfeiler den så snart den ikke lenger stemmer.\n\n## Slik ser det ut i praksis\n\nTa en funksjon som leser varigheter som `1h30m` fra en konfigurasjonsfil og\nregner dem om til sekunder:\n\n```python\n# durations.py\nUNITS = {\"h\": 3600, \"m\": 60, \"s\": 1}\n\n\ndef to_seconds(text: str) -\u003e int:\n    \"\"\"Regn om \"1h30m\" eller \"45s\" til et helt antall sekunder.\"\"\"\n    total, digits = 0, \"\"\n    for char in text:\n        if char.isdigit():\n            digits += char\n        elif char in UNITS and digits:\n            total += int(digits) * UNITS[char]\n            digits = \"\"\n        else:\n            raise ValueError(f\"not a duration: {text!r}\")\n    if digits or not text:\n        raise ValueError(f\"not a duration: {text!r}\")\n    return total\n```\n\nEnhetstestene, skrevet for pytest, sjekker to typer atferd: hva funksjonen tar\nimot, og hva den avviser.\n\n```python\n# test_durations.py\nimport pytest\n\nfrom durations import to_seconds\n\n\n@pytest.mark.parametrize(\n    \"text,expected\",\n    [(\"45s\", 45), (\"2m\", 120), (\"1h30m\", 5400), (\"0s\", 0)],\n)\ndef test_counts_each_unit(text, expected):\n    assert to_seconds(text) == expected\n\n\n@pytest.mark.parametrize(\"text\", [\"\", \"90\", \"h\", \"1x\", \"1.5h\"])\ndef test_refuses_what_it_cannot_read(text):\n    with pytest.raises(ValueError):\n        to_seconds(text)\n```\n\nKjører man `pytest` i mappen, samler den alle filer som heter `test_*.py` eller\n`*_test.py`, og de to funksjonene foldes ut til ni tilfeller, ett per rad med\nparametere. Dokumentasjonen til pytest beskriver hver test som arrange, act,\nassert og cleanup; her er forberedelsen parameterraden, handlingen er det ene\nkallet, og det er ingenting å rydde opp, fordi ingenting utenfor funksjonen blir\nberørt. Kommer noen senere i skade for å sette minuttet til `3600` sekunder,\nfeiler to tilfeller, og rapporten navngir hvert av dem etter parameterne:\n`test_counts_each_unit[2m-120]` viser `7200` mot de forventede `120`, og\n`test_counts_each_unit[1h30m-5400]` viser `111600` mot `5400`. Legg merke til at\nde forventede verdiene er regnet ut for hånd, ikke kopiert fra det koden\nreturnerte første gang.\n\nDe samme kontrollene i standardbibliotekets `unittest` ville vært en underklasse\nav `unittest.TestCase` med metoder der navnet begynner med `test`, og med\n`assertEqual` og `assertRaises`; `python -m unittest` finner som standard filer\nsom matcher `test*.py`. Go har bygd konvensjonen inn i verktøykjeden: en\nfunksjon `func TestXxx(t *testing.T)` i en fil der navnet slutter på `_test.go`,\nkjøres av `go test`.\n\nSkalaen endrer bokføringen, ikke ideen.\n[Databasegeneratoren med 981 testtilfeller](/nb/portfolio/held-the-generator-to-981-tests-and-92-coverage/),\narbeid utført i juli 2026, teller 383 testfunksjoner som blir 981 tilfeller når\nde parameteriserte er utvidet, fordelt på 45 filer og 7 944 linjer. Bygget\nhåndhever et minstekrav på 92 % grendekning, suiten måler omtrent 95 %, og\nadvarsler behandles som feil. Siden er ærlig om hvor langt tallet rekker: to av\nfeilene som ble funnet senere i prosjektet, lå i kode som dekningsrapporten\nviste som dekket.\n\n## Hvor det går galt\n\n**Testene speiler implementasjonen.** En test som griper inn i private\nhjelpefunksjoner eller sjekker den nøyaktige rekkefølgen av interne kall,\nbrekker hver gang koden bygges om, selv om ingenting en kaller kan se, har\nendret seg. Kuefler kaller dette en skjør test og peker på overdreven bruk av\nmocking-rammeverk som den vanligste grunnen til at tester av interaksjoner går\ngalt. Test gjennom det offentlige grensesnittet, sjekk tilstanden som kommer ut\nav kallet i stedet for kallene som førte dit, og bruk ekte objekter der de er\nbillige.\n\n**Testene er avhengige av hverandre.** Én test oppretter en post, den neste\nleser den, og suiten består bare i den rekkefølgen. Kjør én test alene, eller de\nsamme testene i en annen rekkefølge, og den feiler av en grunn ingen leser kan\nse. Becks rammeverk opprettet testdataene og kastet dem igjen for hver test, og\n`unittest`-dokumentasjonen ber om at et testtilfelle er helt selvstendig. Gi\nhver test sin egen fixture, og rydd opp etter den.\n\n**Dekning blir målet.** Dekning viser at en linje ble kjørt, ikke at noe\nsjekket hva den gjorde. En test uten en eneste assertion løfter tallet og\nbeviser ingenting, og _Software Engineering at Google_ advarer om at et krav på\n80 % har en tendens til å bli et tak, så endringer lander på nøyaktig minimum.\nBehandle tallet som et gulv, og les assertions under kodegjennomgangen.\n\n**Én test per metode.** Å gi hver metode i produksjonskoden sin egen\ntestmetode ser ryddig ut, men testen vokser hver gang metoden får en ny gren,\ntil ingen kan si hva den sjekker. Kueflers råd er å teste atferd i stedet: én\natferd per test, oppkalt etter det den beviser, slik at en feilrapport kan leses\nsom en setning om hva som gikk i stykker.\n\n**Testen venter på at tiden skal gå.** En `sleep()` som skal gi noe tid til å\nbli ferdig, gjør suiten tregere ved hver kjøring og feiler likevel på en travel\nmaskin. I en enhetstest er tid bare inndata: gi koden en klokke eller et\ntidsstempel, slik at testen selv kan sette tidspunktet den trenger, i stedet for\nå vente på det.\n\n## Les mer\n\n- [unittest: Unit testing framework](https://docs.python.org/3/library/unittest.html)\n  — rammeverket i Pythons standardbibliotek: fixtures, testtilfeller, suiter,\n  testkjørere, testoppdagelse og forskjellen på en failure og en error.\n- [Anatomy of a test](https://docs.pytest.org/en/stable/explanation/anatomy.html)\n  — pytests forklaring av arrange, act, assert og cleanup.\n- [Get Started](https://docs.pytest.org/en/stable/getting-started.html)\n  — pytests egen introduksjon: vanlig `assert`, testoppdagelse og\n  `pytest.raises`.\n- [Unit Testing](https://abseil.io/resources/swe-book/html/ch12.html)\n  — Erik Kueflers kapittel i _Software Engineering at Google_ om skjøre tester,\n  offentlige API-er, tilstand framfor interaksjoner og testing av atferd.\n- [Simple Smalltalk Testing: With Patterns](https://web.archive.org/web/20150315073817/http://www.xprogramming.com/testfram.htm)\n  — Kent Becks artikkel om rammeverket, om å skrive enhetstester én per klasse\n  og om failures og errors, i en arkivert kopi.\n- [testing](https://pkg.go.dev/testing)\n  — standardpakken for testing i Go: `TestXxx`-funksjoner, `_test.go`-filer og\n  `go test`.\n\n\u003chttps://engineer.company/nb/glossary/unit-test/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Hva som teller som en enhet, hvordan en test holder seg rask og uavhengig, et gjennomregnet eksempel i pytest og vanene som gjør en suite skjør.","formats":{"gemtext":"https://engineer.company/nb/glossary/unit-test/index.gmi","gopher":"https://engineer.company/nb/glossary/unit-test/gophermap","html":"https://engineer.company/nb/glossary/unit-test/","json":"https://engineer.company/nb/glossary/unit-test/index.json","markdown":"https://engineer.company/nb/glossary/unit-test/index.md","pdf":"https://engineer.company/nb/glossary/unit-test/index.pdf"},"kind":"page","language":"nb","title":"Hva er en enhetstest?","url":"https://engineer.company/nb/glossary/unit-test/","version":1}