====== LU16.L02 – BDD in der eigenen Sprache ======
Lösungsbeispiel zu [[..:aufgaben:own-bdd|LU16.A02 – BDD in der eigenen Sprache]].
Weil jede Person Sprache und Framework selbst wählt, gibt es keine einheitliche Lösung. Diese Seite zeigt ein vollständiges Beispiel in JavaScript mit **Cucumber.js** und listet, worauf bei der Bewertung geachtet wird.
===== Auftrag 1 – Framework und Setup =====
* **Sprache:** JavaScript (Node.js 20 oder neuer)
* **Framework:** [[https://github.com/cucumber/cucumber-js|Cucumber.js]], Version 11
* **Installation:**
npm init -y
npm install --save-dev @cucumber/cucumber
* **Ausführen:** ''npx cucumber-js'' oder ''npm test'' (Script in ''package.json'')
==== Projektstruktur ====
warenkorb-bdd/
├── package.json
├── src/
│ └── cart.js
└── features/
├── cart.feature
└── step_definitions/
└── cart_steps.js
===== Auftrag 2 – Miniprojekt Warenkorb =====
==== features/cart.feature ====
Cucumber unterstützt Gherkin auf Deutsch. Die erste Zeile ''# language: de'' schaltet die deutschen Schlüsselwörter ein (''Funktionalität'', ''Szenario'', ''Angenommen'', ''Wenn'', ''Dann'', ''Und'').
# language: de
Funktionalität: Warenkorb
Als Kundin eines Onlineshops
möchte ich Artikel in den Warenkorb legen
damit ich vor dem Bezahlen das Total sehe.
Szenario: Total mit mehreren Artikeln
Angenommen ein leerer Warenkorb
Wenn ich 2 Stück "Apfel" zu 0.80 Franken hinzufüge
Und ich 1 Stück "Brot" zu 4.35 Franken hinzufüge
Dann beträgt das Total 5.95 Franken
Szenario: Ungültige Menge
Angenommen ein leerer Warenkorb
Wenn ich 0 Stück "Apfel" zu 0.80 Franken hinzufüge
Dann erhalte ich die Fehlermeldung "Die Menge muss mindestens 1 sein"
Und beträgt das Total 0.00 Franken
==== features/step_definitions/cart_steps.js ====
const assert = require('node:assert');
const { Given, When, Then } = require('@cucumber/cucumber');
const { Cart } = require('../../src/cart');
Given('ein leerer Warenkorb', function () {
this.cart = new Cart();
this.error = null;
});
When('ich {int} Stück {string} zu {float} Franken hinzufüge', function (quantity, name, price) {
try {
this.cart.add(name, price, quantity);
} catch (error) {
this.error = error;
}
});
Then('beträgt das Total {float} Franken', function (expected) {
assert.ok(Math.abs(this.cart.total() - expected) < 0.005, `Total ${this.cart.total()} statt ${expected}`);
});
Then('erhalte ich die Fehlermeldung {string}', function (message) {
assert.ok(this.error, 'Es wurde kein Fehler ausgelöst');
assert.strictEqual(this.error.message, message);
});
==== src/cart.js ====
// Ein Warenkorb mit Artikeln und Mengen
class Cart {
constructor() {
this.items = [];
}
add(name, price, quantity = 1) {
if (quantity < 1) {
throw new Error('Die Menge muss mindestens 1 sein');
}
this.items.push({ name, price, quantity });
}
total() {
return this.items.reduce((sum, item) => sum + item.price * item.quantity, 0);
}
}
module.exports = { Cart };
==== Testlauf ====
$ npx cucumber-js
........
2 scenarios (2 passed)
8 steps (8 passed)
===== Auftrag 3 – Reflexion (Beispielantworten) =====
- **Auswahl:** Cucumber ist das Original, aus dem behave entstanden ist. Es ist für viele Sprachen verfügbar und gut dokumentiert.
- **Aufwand:** gering, ein npm-Paket. Länger dauert es, die Ausdrücke ''{int}'', ''{float}'' und ''{string}'' in den Schritten richtig zu verwenden.
- **Unterschiede zu behave:** gleiche Gherkin-Syntax und ähnliche Ordnerstruktur. Die Schritte heissen ''step_definitions'' statt ''steps'', geteilte Daten liegen in ''this'' (World) statt in ''context''. Platzhalter sind Cucumber Expressions statt ''parse''-Formate.
- **Stolpersteine:** Pfeilfunktionen ''() => {}'' haben kein eigenes ''this''. Schritte müssen deshalb mit ''function () {}'' geschrieben werden. Fliesskommazahlen brauchen eine Toleranz.
- **Vorteile:** Die Szenarien sind auch für Nicht-Programmierende lesbar und dienen als lebende Spezifikation.
- **Ausbildungsbetrieb:** Akzeptanztests für Webshops oder Formulare, bei denen Fachpersonen die Szenarien mitschreiben.
- **Verbesserung:** Für kleine Funktionen ist der Aufwand höher als bei Unit Tests. Eine Kombination ist sinnvoll: BDD für Abläufe, Unit Tests für Details.
- **Berufsalltag:** ja, wenn Fachabteilung und Entwicklung eng zusammenarbeiten. Sonst genügen oft Unit- und Integrationstests.
===== Bewertungshinweise =====
Eine gute Abgabe
* nennt Framework, Version und Installationsbefehle,
* enthält mindestens ein Feature mit zwei Szenarien in korrekter Gherkin-Syntax (Given – When – Then),
* testet nicht nur den Normalfall, sondern auch einen Fehlerfall,
* zeigt einen erfolgreichen Testlauf (Screenshot oder Log),
* beantwortet alle acht Reflexionsfragen begründet und mit Bezug zum eigenen Projekt.
----
{{tag>M450-LU16 M450-B1A M450-C2I}}
[[https://creativecommons.org/licenses/by-nc-sa/4.0/|{{https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png}}]] Kevin Maurizi