Tests uitvoeren en filteren

Om de tests in een bestand uit te voeren, roep je de compiler aan in de testmodus. De opdracht zig test compileert en voert elk testblok uit dat hij vindt.

Je geeft zig test het bronbestand van de hoofdmodule. De opdracht haalt tests uit dat bestand en uit elk bestand dat via @import wordt bereikt.

Na een run toont Zig hoeveel tests zijn geslaagd. Een regel zoals "All 7 tests passed" betekent dat elk test-blok zonder fout is teruggekeerd.

Bij een mislukking toont Zig de naam van de test, de controle die is mislukt en een stacktrace. De name die je hebt gekozen, maakt dit leesbaar.

Voer alleen de tests uit die je nodig hebt met --test-filter. Alleen tests waarvan de naam de opgegeven tekst bevat, worden uitgevoerd.

Terwijl je één functie herstelt, voer je alleen de bijbehorende tests opnieuw uit, zodat je snel feedback krijgt. De optie --test-filter zoekt naar een deeltekenreeks in de testnaam.

Geef vanuit een test de speciale error.SkipZigTest terug om deze als overgeslagen in plaats van mislukt te markeren. Dat is handig voor gevallen die nog niet klaar zijn.

De samenvatting telt overgeslagen tests apart van geslaagde en mislukte tests, zodat een skip nooit een echt probleem in je testsuite verbergt.

In een echt project voer je tests meestal uit via het buildsysteem. Een geconfigureerde stap zig build test compileert en voert ze uit.

Een bestand met alleen test-blokken en zonder main-functie werkt nog steeds met zig test. De testrunner levert het startpunt voor je.

Omdat je tests met één opdracht uitvoert, kun je dat na elke wijziging doen. Snelle feedback houdt een Zig-codebase betrouwbaar.

Je hebt tests uitgevoerd met zig test, de samenvatting gelezen, op naam gefilterd, tests overgeslagen met error.SkipZigTest en kennisgemaakt met zig build test. ✅