#2758: rest.test.js [DE]

Test-Suite für das REST-URL-Erstellungsmodul (rest.js). Überprüft die Korrektheit der Basis-URL-Konstante, der Serialisierung von Abfrageparametern und der Zusammenstellung von Service-URLs. Verwendet Jests globale it/describe/expect-API. Diese Testdatei stellt sicher, dass Änderungen am URL-Routing (wie die Migration des REST-Endpunkt-Präfixes von /rest zu /rs) die URL-Konstruktionslogik, von der Dutzende API-aufrufende Komponenten abhängen, nicht stillschweigend beschädigen.

Architektur

Teststruktur

baseURL – eine einzelne Behauptung, dass die Konstante dem erwarteten String entspricht. Dies fungiert als Kanarienvogel: Sollte sich die Basis-URL jemals unerwartet ändern, wird dies von diesem Test erfasst.

createQueryParams – ein beschriebener Block mit vier Fällen: leere Parameter (gibt leeren String zurück), ein einzelnes Schlüssel-Wert-Paar, mehrere mit & verbundene Schlüssel-Wert-Paare und Parameter, die Sonderzeichen enthalten, die URI-kodiert werden müssen (z. B. deutsche Umlaute in Schwarzwälder Kirschtorte).

getServiceURL – ein beschriebener Block mit drei Fällen: undefinierte Parameter (hängt nur den Pfad an die Basis an), leere Parameter (gleich) und vorhandene Parameter (vollständige URL mit Abfragezeichenfolge). Testet die Zusammenstellung der vollständigen REST-Endpunkt-URL aus einem Service-Pfad und optionalen Parametern.

Testgetriebene Routing-Migration

Diese Testdatei spielte eine entscheidende Rolle während der Migration des API-Präfixes. Als die Basis-URL von /rest auf /rs geändert wurde, dienten die Test-Erwartungen als Spezifikation: Zuerst wurden alle Behauptungen aktualisiert, um die neuen erwarteten Werte widerzuspiegeln, dann wurde die Implementierung in rest.js geändert, bis die Tests bestanden wurden. Später verlagerte die Vite-Migration die Proxy-Behandlung auf die Build-Tool-Ebene, wodurch baseURL als leerer String anstelle von /rs testbar wurde.

Git-Verlauf

Commit	Was wurde geändert
`bf988bc6d`	Änderte den erwarteten Wert von `baseURL` von `'/rs'` auf `''` (leerer String). Dies begleitete die Migration von react-scripts zu Vite: Der Vite-Entwicklungsserver übernimmt die Proxy-Weiterleitung von `/rs`- und `/rest`-Pfaden an das Backend, sodass die Basis-URL-Konstante der React-App das Präfix nicht mehr benötigt, da die Proxy-Ebene dies transparent handhabt.
`f744162e7`	Aktualisierte alle Test-Erwartungen von `'/rest'` auf `'/rs'` in der gesamten Datei – vier Vorkommen in den `getServiceURL`-Testfällen und eines in `baseURL`. Dies spiegelte die Konsolidierung der Backend-REST-Endpunkte wider, bei der das alte `/rest`-Präfix durch `/rs` ersetzt wurde, um Konsistenz mit dem Wicket-Seiten-Mounting-Schema zu erreichen.
`7ea575588`	Erstellte die Testdatei mit der anfänglichen Test-Suite unter Verwendung von `'/rest'` als Basis-Service-Präfix. Etablierte das Muster zum Testen leerer Parameter, einzelner Parameter, mehrerer Parameter und URI-kodierter Sonderzeichen. Die spielerischen Testdaten (Kuchen, Geschmack, Schwarzwälder Kirschtorte) stammen von hier.