Unittests

Definition

Ein Unit Test ist ein Stück Code, das einen kleinen, spezifischen Teil Ihres Codes (eine 'Unit') isoliert aufruft und überprüft, ob er sich wie erwartet verhält.

Download Übung OpenUI5

Wir wollen nun unsere eigenen Unit Tests schreiben.
Als Grundlage dient das SAP-Beispiel aus dem Tutorial Step 26.

• Download des Beispiels per Zip Link
• oben rechts auf den Donwload Button klicken
  

Installieren der Übung

> cd sap.m.tutorial.walkthrough.26

> npm install

> npm start

Übung Unittest anlegen (2)

• Die neue Datei formatter.js mit folgenden Code füllen:

sap.ui.define([
	"ui5/walkthrough/model/formatter",
	"sap/ui/model/resource/ResourceModel",
], (formatter, ResourceModel) => {
	"use strict";

	QUnit.module("Formatting functions", {});

	QUnit.test("Should return the translated texts", (assert) => {
        const oResourceModel = new ResourceModel({
            bundleUrl: sap.ui.require.toUrl("ui5/walkthrough/i18n/i18n.properties"),
            supportedLocales: [
                ""
            ],
            fallbackLocale: ""
        });

        const oControllerMock = {
            getOwnerComponent() {
                return {
                    getModel() {
                        return oResourceModel;
                    }
                };
            }
        };

        const fnIsolatedFormatter = formatter.statusText.bind(oControllerMock);

        // Assert
        assert.strictEqual(fnIsolatedFormatter("A"), "New", "The long text for Status A is correct");
        assert.strictEqual(fnIsolatedFormatter("B"), "In Progress", "The long text for Status B is correct");
        assert.strictEqual(fnIsolatedFormatter("C"), "Done", "The long text for Status C is correct");
        assert.strictEqual(fnIsolatedFormatter("Foo"), "Foo", "The long text for Status Foo is correct");
	});
});

Übung Unittest anlegen (4)

• Wir legen innerhalb des unit Ordners die Datei unitTests.qunit.js an
• Wir fügen dort folgenden Code ein:

QUnit.config.autostart = false;

sap.ui.require(["sap/ui/core/Core"], async(Core) => {
	"use strict";

	await Core.ready();

	sap.ui.require([
		"ui5/walkthrough/test/unit/model/formatter"
	], () => {
		QUnit.start();
	});
});

• So sollte der Verzteichnisbaum nun aussehen:
  

QUnit Erläuterungen

• QUnit.module „gruppiert“ alle nachfolgenden Tests unter dem angegebenen Namen.

QUnit.module("Eigene Tests", {}); 

• QUnit.test deklariert den eigentlichen Unit Test

QUnit.test("Should return the translated texts", (assert) => {... 

• Mit assert können Testbedingungen deklariert werden. Eine Übersicht über alle möglichen Assertion-Methoden findet sich hier

assert.strictEqual(fnIsolatedFormatter("A"), "New", "The long text for Status A is correct");... 

Übung mit eigenen Tests erweitern (1).

• Wir erweitern die Datei test/unit/model/formatter.js nach den asserts nach der Zeile }); mit folgendem Code:

    QUnit.module("Eigene Tests", {});

    QUnit.test("Demonstration von Assert-Funktionen", function (assert) {
        // Gleichheit (ohne Typ-Prüfung)
        assert.equal(5, "5", "equal: Werte sind gleich (implizite Typkonvertierung)");

        // Strikte Gleichheit (mit Typ-Prüfung)
        assert.strictEqual(5, 5, "strictEqual: Werte und Typen sind gleich");

        // Ungleichheit
        assert.notEqual(5, 6, "notEqual: Werte sind nicht gleich");

        // Wahrheitswert
        assert.ok(true, "ok: Der Wert ist wahr");

        // Tiefe Gleichheit für Objekte/Arrays
        assert.deepEqual({ a: 1, b: 2 }, { a: 1, b: 2 }, "deepEqual: Objekte sind strukturell gleich");

        // Prüfung auf Typ
        assert.propEqual({ value: "test" }, { value: "test" }, "propEqual: Objekte haben gleiche Eigenschaften");

        // Prüfung auf geworfene Ausnahme
        assert.throws(
            function () { throw new Error("Test"); },
            Error,
            "throws: Funktion wirft erwartete Ausnahme"
        );

        // Fehler provozieren
        var v_now = "1.9.2024 15:00:00";
        assert.equal(v_now, new Date().toLocaleString(), "Datum ist gleich");

        // Prüfung auf erwartete Anzahl von Assertions
        assert.expect(8);
    });

Best Practices Unit Tests

• Tests isoliert halten
• Mocks für externe Abhängigkeiten verwenden
• Aussagekräftige Testbeschreibungen
• Abdeckung wichtiger Geschäftslogik