Archive. Posts from 2004 to 2016, kept as they were written. My current blog is at dariuszparys.com.

Hat man vor mit Javascript größere Anwendungen zu schreiben, so kommt man nicht herum sich über ein Testing Framework Gedanken zu machen. Gerade bei einer dynamischen Sprache wie Javascript ist Testing durchaus sinnvoll.

Es gibt verschiedene Testing Frameworks für Javascript, ich habe mir Jasmine herausgepickt. Es ist einfach in der Benutzung und hat alle wesentlichen Features die ich benötige.

Unit Testing mit Jasmine

Exemplarisch zeige ich mal die Benutzung von Jasmine. Ich halte mich hierbei an die Standardverzeichnisstruktur die mit den Beispielen von Jasmine mitkommt.

Verzeichnisstruktur

1 2 3 4 5 SpecRunner.html specs PersonSpec.js src Person.js

SpecRunner.html enthält die Logik für das Testing Framework. Die Specs und dessen Funktionen die getestet werden sollen, werden über eine Skriptreferenz eingebunden.

Einbinden von Spec und Objekt

1 2 <script src="specs/PersonSpec.js" type="text/javascript"></script> <script src="src/Person.js" type="text/javascript"></script>

Das folgende Beispiel ist ein Personen Objekt, welches den vollständigen Namen ausgeben soll und anzeigt ob heute Geburtstag ist.

Spezifikation für Person

Die Spezifikation, also der eigentliche Test, wird in die Datei PersonSpec.js gepackt. Bei Behaviour Driven Development werden die Tests in Spezifikation gepackt, die entsprechend den Kontext des Tests anhand der Funktionalität beschreiben. Jasmine stellt hierfür diverse Funktionen zur Verfügung.

Die erste Jasmine Spec

1 2 3 4 5 6 7 describe("Person", function() { it("should return a fullname", function() { var person = new Person("Dariusz", "Parys"); expect(person.getFullName()).toEqual("Dariusz Parys"); }); });

Das ist die erste Spezifikation. Die Funktion describe legt den Kontext fest. In diesem Fall alles rund um Person. Diese Kontexte können auch verschachtelt sein und eigene Initialisierungsfunktionen mittels beforeEach beherbergen. Eine Initialisierungsfunktion wird für diesen kurzen Test noch nicht benötigt. Beim ausführen erhält man folgende Fehlermeldung vom SpecRunner.

Erste Person Implementierung

Die fehlende Implementierung lässt den Test kläglich scheitern. Schaffen wir Abhilfe und implementieren die Funtion getFullName in der Datei Person.js

Implementierung von Person

1 2 3 4 5 6 7 8 function Person( firstName, lastName ) { this.firstName = firstName; this.lastName = lastName; }; Person.prototype.getFullName = function() { return this.firstName + " " + this.lastName; };

Ein einfacher Refresh auf den SpecRunner und das Ergebnis ist entsprechend grün.

Geburtstag implementieren

Geburtstage sind wichtig, wer trinkt nicht mal gerne auf das Wohl des anderen und feiert diesen hoch? Genau deswegen benötigt unser Personen Objekt (streng genommen nur eine Funktion) noch einen Geburtstag. Und diesen möchte ich auch abfragen. Dazu brauch ich jedoch erstmal zwei weitere Tests. Einmal ob die Person heute Geburtstag hat und einen zweiten für ein Datum an dem die Person nicht Geburtstag hat. Die Implementierung ist ok solange man den Test nicht kurz vor Mitternacht ausführt - da feiert man ja eigentlich auch. Doch wir haben ja Maschinen die uns dienen und es gibt autmatisierte Test- und Buildsysteme, da kann der Fall durchaus auftreten das die Testimplementierung kläglich scheitert. Aber nicht für meinen Blogpost. Hier kann sich der Leser entsprechend in den Kommentaren austoben und vorschläge einreichen wie man diesen Test besser löst.

Weitere Specs

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 describe("Person", function() { var person; beforeEach( function() { person = new Person("Dariusz", "Parys"); }); it("should return a fullname", function() { expect(person.getFullName()).toEqual("Dariusz Parys"); }); it("should have birthday today", function() { person.setBirthday( new Date(Date.now()) ); expect(person.isBirthdayToday()).toEqual(true); }); it("should have not birthday today", function() { var today = new Date(Date.now()); if( today.getDate() == 1 ) { today.setDate(2); } else { today.setDate(today.getDate() - 1 ); } person.setBirthday( today ); expect(person.isBirthdayToday()).toEqual(false); }); });

Wieder im SpecRunner refreshen und wieder rot. Klar, fehlt ja noch die Implementierung

Weitere Funktionen in person.js

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 function Person( firstName, lastName ) { this.firstName = firstName; this.lastName = lastName; }; Person.prototype.getFullName = function() { return this.firstName + " " + this.lastName; }; Person.prototype.setBirthday = function( birthday ) { this.birthday = birthday; }; Person.prototype.isBirthdayToday = function() { var today = new Date(Date.now()); if( this.birthday.getDate() == today.getDate() && this.birthday.getMonth() == today.getMonth() ) { return true; } else { return false; } };

SpecRunner refreshen und alles müsste im grünen Bereich sein.

Alternativen

Neben Jasmine gibt es noch eine Reihe weiterer BDD / Unit Testing Frameworks für Javascript. Ein paar dieser Frameworks sind in diesem Post auf Stackoverflow zusammengefasst.

Unterm Strich lassen sich Javascript Anwendungen Testgetrieben entwickeln. Die notwendigen Frameworks gibt es, es liegt nur an einem selbst ob man es einsetzen möchte oder nicht.