Jenkins

WebdriverIO erbjuder en nära integration med CI-system som Jenkins. Med junit-rapportören kan du enkelt felsöka dina tester samt hålla koll på dina testresultat. Integrationen är ganska enkel.

1. Installera junit testrapportören: $ npm install @wdio/junit-reporter --save-dev)
2. Uppdatera din konfiguration för att spara dina XUnit-resultat där Jenkins kan hitta dem, (och specificera junit-rapportören):

// wdio.conf.js
module.exports = {
    // ...
    reporters: [
        'dot',
        ['junit', {
            outputDir: './'
        }]
    ],
    // ...
}

Det är upp till dig vilket ramverk du väljer. Rapporterna kommer att vara liknande. För denna handledning kommer vi att använda Jasmine.

Efter att du har skrivit några tester kan du konfigurera ett nytt Jenkins-jobb. Ge det ett namn och en beskrivning:

Se sedan till att det alltid hämtar den senaste versionen av ditt repository:

Nu kommer den viktiga delen: Skapa ett build-steg för att köra skalkommandon. Build-steget behöver bygga ditt projekt. Eftersom detta demoprojekt endast testar en extern app behöver du inte bygga något. Installera bara nodeberoenden och kör kommandot npm test (vilket är ett alias för node_modules/.bin/wdio test/wdio.conf.js).

Om du har installerat ett tillägg som AnsiColor, men loggarna fortfarande inte är färgade, kör tester med miljövariabeln FORCE_COLOR=1 (t.ex. FORCE_COLOR=1 npm test).

Efter ditt test vill du att Jenkins ska spåra din XUnit-rapport. För att göra det måste du lägga till en post-build-åtgärd som kallas "Publish JUnit test result report".

Du kan också installera ett externt XUnit-tillägg för att spåra dina rapporter. JUnit följer med den grundläggande Jenkins-installationen och är tillräcklig för nu.

Enligt konfigurationsfilen kommer XUnit-rapporterna att sparas i projektets rotkatalog. Dessa rapporter är XML-filer. Så allt du behöver göra för att spåra rapporterna är att peka Jenkins till alla XML-filer i din rotkatalog:

Det var allt! Du har nu konfigurerat Jenkins för att köra dina WebdriverIO-jobb. Ditt jobb kommer nu att ge detaljerade testresultat med historikdiagram, stacktrace-information om misslyckade jobb och en lista över kommandon med nyttolast som användes i varje test.