Tests¶
Das Add-on ändert Dinge an einer Zentrale, die ein Haus steuert. Deshalb ist fast jede Funktion automatisch getestet, und zwar auf mehreren Ebenen, bis hin zu Durchläufen im echten Browser gegen den echten Server und eine nachgebaute CCU.
Überblick¶
| Ebene | Was echt ist | Was nachgebaut ist | Tests | in der CI |
|---|---|---|---|---|
| Unit (Vitest) | Funktionen und einzelne Komponenten der App | – | 309 in 58 Dateien | ✅ |
| Go | Server-Pakete; Integration: der ganze Server | die CCU (Fake-CCU), openccu-lite (Fake-Lite) | 335 Testfunktionen in 81 Dateien | ✅ |
| Protokoll | jede Nachricht des Servers in den Go-Tests, jede Nachricht des Mocks an die App in den E2E-Tests | – | gegen protocol/schema.json |
✅ |
| E2E mit Mock | App im Browser | der WebSocket (im Browser) | 35 + 2 + 2 + 1 + 4 | ✅ |
| E2E gegen den Stack | Browser, App, Go-Server, WebSocket, XML-RPC, ReGa-Aufrufe | nur die CCU (Fake-CCU) | 74 | ✅ |
| openccu-lite-VM | openccu-lite aus seinem Release-Image (QEMU), occulited, lighttpd, Sitzungs-Gate, Installation des Pakets | nichts; aber ohne Funkmodul, also ohne Geräte | 3 Phasen | ✅ bei Lite-Änderungen, wöchentlich, vor Releases |
| Screenshot-Vergleich | Darstellung in 3 Größen, hell und dunkel | der WebSocket | 72 | ✅ |
Zusammen über 600 Tests, dazu 72 Screenshot-Vergleiche.
flowchart LR
subgraph Stack["E2E gegen den Stack"]
B["Chromium"] --> V["Vite :4201"] --> G["Go-Server :28088"] --> F["Fake-CCU<br/>ReGa, XML-RPC, WebUI, HMServer"]
F -- "Events" --> G
end
Die Fake-CCU¶
Herzstück der Tests ist go-server/pkg/fakeccu, eine CCU zum Mitnehmen (gut 3.700 Zeilen Go). Sie lädt
eine Fixture (fixtures/demo-ccu.json: 3 Räume, 2 Gewerke, 36 Kanäle, Benutzer Admin/secret und
Gast/gast, Gerätebeschreibungen und Paramsets für BidCos-RF und HmIP-RF, Systemvariablen, Programme,
Favoriten, ein Gerät im Posteingang) und startet fünf Server:
- ReGa: erkennt jedes Skript des Servers an seiner Vorlage, denn sie macht aus jeder der 58 Vorlagen
einen regulären Ausdruck, liest die eingesetzten Werte heraus und antwortet wie
rega.exe. Einen HM-Script-Interpreter braucht es dafür nicht. - XML-RPC für BidCos-RF, HmIP-RF, VirtualDevices und BidCos-Wired: Gerätebeschreibungen, Paramsets, Anlernen,
Verknüpfungen, Firmware, Gerätetausch … Änderungen schickt sie wie die echte CCU als Events an die
angemeldeten Callbacks. Nach einem
putParamsetstehtCONFIG_PENDINGdrei Sekunden auftrue. - WebUI:
Session.login, die Admin-Aufrufe per JSON-RPC, die CGI-Seiten für Backup, Restore, Firmware, Add-ons und Werkseinstellungen,fileupload.ccc. - HMServer für Heizgruppen.
- Steuerung für Tests:
POST /fake/setlässt ein Gerät einen Wert melden (z. B. ein Fenster öffnet sich),POST /fake/resetsetzt alles auf die Fixture zurück.
Konfigurationsdateien wie rfd.conf, netconfig, firewall.conf und groups.gson kopieren die Tests in
ein frisches Verzeichnis, damit jeder Lauf sauber beginnt.
Eine Fixture lässt sich aus der eigenen CCU erzeugen (bun run export:ccu). fixtures/my-ccu.json ist ein
anonymisierter Export einer echten Zentrale mit 482 Kanälen; er dient als Prüfstein für Gerätebeschreibungen
aus der Praxis.
Unit-Tests (Vitest)¶
bun run test · Konfiguration vitest.config.mts (jsdom, Testing Library, auf derselben Laufzeit wie die App,
TanStack Redact). Die Testdateien laufen in Worker-Threads (pool: 'threads'): Der Standard-Pool forks startet
seit Vitest 5.1 einen Watchdog-Prozess, den Bun nicht unterstützt (child.channel.unref() fehlt).
Getestet werden vor allem reine Logik und kritische Komponenten:
- Generische Kachel gegen alle Fixtures (
ParamsetView.test.tsx): jede Paramset-Beschreibung ausfixtures/*.json, auch aus dem Export der echten CCU, muss sich rendern lassen. 89 Fälle. - Einstellungen: welcher Parameter welches Bedienelement bekommt (
settingKinds.test.ts) - Wochenprogramme von Thermostaten und Aktoren, Programmmodell, Verknüpfungsvorlagen
- Events in den Cache einspielen, Kanäle sortieren und ausblenden (
channels.test.ts) - Diagramme: Skalen, Ticks, CSV (
chart.test.ts), Kachel-Layout - Validierungen der Einrichten-Seiten: Firewall, Netzwerk, LAN-Gateways, Zertifikat, Anlernen, Benutzer
- Zuordnung der Kanaltypen zu Kacheln (
registry.test.ts) - Übersetzungen: Deutsch und Englisch haben dieselben Schlüssel, keiner ist leer
Go-Tests¶
bun run test:go · Coverage: bun run test:go:coverage
- Pakete: ReGa (Skripte, Parser, Validierung, Programm-Code), XML-RPC-Client und -Server, Anmeldung und Tokens, Einstellungen, Diagramme, Push, Audit, Add-ons, Logs …
- Integration (65 Tests):
go-server/integration_test.gobaut den Stack auf, die Tests stehen nach Domänen instack_devices_test.go,stack_logic_test.goundstack_system_test.go. Jeder Test startet die Fake-CCU auf freien Ports und den echten Server mit temporären Dateien, wartet auf die Anmeldung für Events und spricht dann über einen WebSocket-Client mit ihm: anmelden, schalten, Events, Rechte, Admin-Token, Paramsets, Anlernen, Verknüpfungen, Programme, Backup … - openccu-lite (
go test -tags lite ./...): Dieselbe Fake-CCU im Lite-Modus (fakeccu.CCU.Lite) hat keine ReGa und keine WebUI, sondern beantwortet occulites APIs aus derselben Fixture: Metadaten (Namen, Räume, Gewerke, auch verschachtelt mit Verschieben und Löschen), den Change-Stream der Metadaten, Sitzungen, Zustandsspeicher, Event-Stream mitresync, Servicemeldungen und Heizgruppen. Die Integrationstests ingo-server/lite_integration_test.gostarten den Lite-Server dagegen: Anmeldung über das Gate, Räume und Kanäle, Schalten mit dem Event aus dem Stream, Umbenennen, Layouts, Favoriten, Posteingang, Heizgruppen, virtuelle Taster, Servicemeldungen, Gesundheit, Regeln und Push, dazu von Geräten geerbte Räume (TestLiteInheritedRooms) und was dort anders geht (TestLiteLimits: Diagramm ohne Systemprotokoll, Sprache inDATA_DIR, nur Sticky-Meldungen bestätigen,elevatenur für Administratoren).TestLiteCallsWithTheUsersSessionprüft, dass die Funkdienste überlite-rpcgehen und Änderungen mit der Sitzung des Nutzers.TestLiteLayoutsFollowRoomsMovedInOpenccuLiteverschiebt einen Raum in openccu-lite und löscht den darüber,TestLiteResyncliest nachresyncden Zustandsspeicher neu. - Protokoll-Vertrag: Die Hilfsfunktion, die Nachrichten des Servers liest, prüft jede gegen
protocol/schema.json. Ein eigener Test stellt sicher, dass das Schema unbekannte Felder ablehnt.
E2E mit gemocktem WebSocket¶
bun run test:e2e · Konfiguration playwright.config.ts
Die App läuft im Vite-Dev-Server und in echtem Chromium; nur window.WebSocket ist durch einen Mock ersetzt
(e2e/helpers/websocketMock.ts), der Anfragen im Browser beantwortet und über window.__wsMock steuerbar
ist: Events auslösen, das nächste Schalten scheitern lassen, Alarme setzen, gesendete Nachrichten prüfen.
Damit der Mock nicht unbemerkt vom echten Server abweicht, zeichnet er jede Nachricht an die App auf, und
nach jedem Test prüft e2e/helpers/protocol.ts sie gegen ServerMessage in protocol/schema.json, wie die
Go-Tests die Nachrichten des Servers. Weicht eine Antwort oder Push-Nachricht ab, schlägt der Test fehl und
nennt die Nachricht.
Abgedeckt sind die Kacheln (Licht, Dimmer, Farblicht, Rollladen, Türschloss nur mit Geste, Fenster, Melder,
Sirene, Zutritt, Eingänge, Sensoren für Regen, Licht, CO₂, Feinstaub, Boden, Neigung und Netzausfall, Bewässerung, Fensterantriebe, Thermostate, Energie), Events und Event-Schübe, Rücknahme bei Fehlern, Batterie und
Erreichbarkeit, Meldungen, Alarme, Favoriten, Startseite, Kacheln anordnen, die generische Kachel und
Alle Geräte. auth.spec.ts prüft Anmeldung, Token über einen Neustart hinweg und Abmelden. lite.spec.ts
lässt den Mock als openccu-lite antworten (installWebSocketMock(page, { lite: true })) und prüft, dass
die App Programme, Systemvariablen, Alarme und die Systemeinstellungen ausblendet, nicht danach fragt und
stattdessen auf Automationen und die Seiten von openccu-lite verweist. lite-session.spec.ts prüft, dass eine
abgelaufene Sitzung zur Anmeldung von openccu-lite führt statt ins eigene Login-Formular. boot-error.spec.ts
lässt das Skript der App mit 503 scheitern, wie lighttpd, wenn der Server nicht läuft, und prüft den Hinweis
in index.html statt einer weißen Seite, auch mit dem, was status.cgi meldet. Das Skript selbst prüft
go-server/status_cgi_test.go: welche Zeile des Logs es herausgibt (nur die seit dem letzten Start, mit der
der Server abgebrochen ist), und dass es „läuft“ nur für den Prozess des Servers meldet.
go-server/lighttpd_conf_test.go prüft, dass die Weiterleitung von lighttpd (beide Fragmente) auf den
Standardport des Servers zeigt, dass lighttpd-conf.sh einen WS_PORT aus mui.conf übernimmt und
ungültige Werte verwirft, dabei auf demselben Port landet wie der Server, der mui.conf über rc.d/mui
einliest (mit BusyBox, auch mit Kommentar hinter dem Wert oder Windows-Zeilenende), und dass keiner der Ports dem Mediola NEO Server gehört (8088, 9099).
bun run test:e2e:coverage misst dabei die Abdeckung des Frontend-Codes (nyc, Bericht unter
coverage/playwright).
E2E gegen den Stack¶
bun run test:stack (braucht Go) · Konfiguration playwright.stack.config.ts
Playwright startet drei Prozesse: die Fake-CCU, den echten Go-Server (mit allen Dateipfaden in einem
temporären Verzeichnis) und Vite. Die Update-Prüfung des Add-ons fragt die Fake-CCU statt GitHub
(ADDON_RELEASE_URL), wie schnell GitHub antwortet, spielt also keine Rolle. Jeder Test setzt die Fake-CCU
zurück, meldet sich über die Anmeldemaske an und bedient die App wie ein Mensch. Die Kette ist echt:
Browser → Vite-Proxy → Go-Server → Fake-CCU und die Events zurück.
Die 74 Tests decken praktisch jede Funktion von Einrichten ab, zum Beispiel:
- Licht schalten und Live-Events von einem anderen „Gerät“, Geräteprobleme, Dimmer
- Geräteeinstellungen mit Vorschau und Übertragungsstatus, Gastrechte, abgelaufenes Admin-Token
- Umbenennen, Räume und Gewerke, Anlernen, Posteingang, Löschen, Anlernen mit KEY/SGTIN, Wired-Gerätesuche
- Systemvariablen, Programm-Editor, Skript testen, Als neues Programm speichern
- Direktverknüpfungen mit Vorlage und mit allen Parametern
- Wochenprogramme für Thermostat und Schaltaktor, Heizgruppen
- Firmware-Update, Backup erstellen und einspielen, CCU-Firmware mit Lizenz, Add-ons installieren
- Benutzer, Passwort ändern, angemeldete Geräte abmelden
- Zeitzone und Zeitserver, Standort, Netzwerk, Firewall, LAN-Gateway, Zertifikat, SSH, Sicherheitsschlüssel, Sitzungs-Timeout, Sicherheitsstufe, Werkseinstellungen
- Diagramme, Systemprotokoll, virtuelle Taster, Funktionstest, Energiepreise, Info-LED
Auf einer openccu-lite-VM¶
scripts/lite-vm-test.sh <openccu-lite-x86_64-ova-*.zip> <mui-*-x86_64-lite.tar.gz> (braucht
qemu-system-x86_64, mit KVM in wenigen Minuten, ohne deutlich langsamer)
Die Tests gegen die Fake-Lite prüfen, was MUI aus occulites APIs macht. Ob das Paket auf einem echten
openccu-lite überhaupt installiert und läuft, prüft erst dieser Test: Er bootet das x86_64-Image eines
openccu-lite-Releases headless in QEMU, wie openccu-lites eigenes scripts/lite-qemu-test.sh, legt den
ersten Administrator an, stellt HmIP-RF auf Keins (seit openccu-lite 2 startet hmipserver ohne
Funkmodul nur so, als HMServer.jar mit den virtuellen Geräten; PUT /api/system/v1/radio/connections)
und installiert das Paket über occulites Add-on-API, wie dessen Seite Zusatzsoftware es hochlädt. Dann läuft go-server/litevm (Build-Tag litevm) in fünf Phasen gegen die
VM, über lighttpd und occulites Sitzungs-Gate:
- prepare: Anmeldung über das Gate (
platform: lite, Administrator), alles, was die App beim Start liest, ein Raum mit Umlauten in occulites Metadaten, sein Layout und die Sprache inDATA_DIR. - verify: nach einem Neustart des Dienstes
addon-mui, nach einer erneuten Installation (Update) und nach einem Neustart des ganzen Systems sind Raum, Layout und Sprache noch da. Nach dem Neustart kommt das Add-on von selbst wieder ("start": "early", es wartet selbst auf die Funkdienste). - levels: Konten mit den Stufen configure und operate, jedes über das Gate angemeldet.
configure benennt einen Raum um, und die Änderung kommt mit seiner eigenen Sitzung bei occulited an.
Heizgruppen und Gerät löschen bekommen
FORBIDDEN, operate darf nichts einrichten. Der Administrator legt eine Heizgruppe mit Umlauten über occulites Gruppen-API an. Ihr Gerät liegt in hmipserver (VirtualDevicesläuft ohne Funkmodul, mit HmIP-RF auf Keins). MUIs Geräteliste für configure muss dieselbe sein, die lite-rpc (/api/rpc/v1/json/VirtualDevices) dieser Sitzung direkt gibt. An diesem Gerät setzt operate einen Wert (setDatapointüber lite-rpc,rpc:operate) und liest ihn mitgetParamset(VALUES) zurück. Ein Event gibt es dafür nicht: hmipserver schickt für einen Wert an einer Heizgruppe ohne Mitglieder keins, erst die Antwort eines Mitglieds brächte eins, und die VM hat keine Geräte (openccu-lite#12; bis 1.0.0-beta.1 kam nur zufällig eine Statusmeldung von occulited an). Antwortet hmipserver nach dem Anlegen der Gruppe auch nach einer Minute nicht (503 down, siehe Plan), meldet der Test den Schritt als übersprungen; jeder andere Fehler und ein Wert, der nicht zurückkommt, bleiben rot. configure ändert eine Einstellung (MASTER,rpc:configure) und setzt sie zurück; operate bekommt dabeiFORBIDDEN. - fresh: nach Deinstallieren (
POST /api/system/v1/addons/mui/uninstall) und neuer Installation sind Layout und Sprache weg, der Raum in occulites Speicher ist noch da. - logout: Ein Abmelden in openccu-lite schließt die offene Verbindung (Neuprüfung jede Minute), die
nächste bekommt
SESSION_REQUIREDoder wird vom Gate abgewiesen.
Dazu öffnet scripts/lite-vm-browser.mjs die App in Chrome, wie openccu-lites Rahmen sie öffnet
(/addons/mui/?theme=dark&lang=en, über lighttpd und das Gate): Der Raum aus dem Test steht da, Thema und
Sprache kommen aus den Parametern, und es gibt keine Konsolenfehler, keine Ausnahmen und keine
fehlgeschlagenen Anfragen unter /addons/mui/. Dafür legt die Phase showcase vorher drei Räume mit je
einer Heizgruppe an (ein virtueller Thermostat ist das einzige Gerät, das die VM ohne Funkmodul haben
kann). Dann fotografiert das Skript die App in openccu-lites Oberfläche (/nav/mui, die Seite seines
Menüeintrags) hell und dunkel auf Desktop und Handy und darin einige Seiten der App, so wie ein Nutzer sie
erreicht: screenshots/ im Artefakt lite-vm-logs. Dabei prüft es auch, dass es auf openccu-lite keinen
Link in die WebUI gibt und die Hilfe auf openccu-lites Doku und Lizenzen zeigt. Bietet openccu-lite das ganze Fenster
für MUI an (seit 1.0.0-dev.45), schaltet es das für den Testnutzer ein, fotografiert MUI ohne openccu-lites
Leiste auf Desktop und Handy und prüft, dass MUIs Menü den Weg zurück (/) anbietet. Hat das System die Gerätebilder (seit 1.0.0-dev.45), prüfen Test und Skript sie
auch: getDeviceImages kennt die Typen und sagt, wo openccu-lite sie ausliefert, das Bild des
Heizgruppen-Geräts kommt dort an, und in der Geräteliste ist ein Bild wirklich geladen
(app-device.png zeigt die Geräteseite).
Dazwischen prüft das Skript, dass /addons/mui/ ohne Sitzung zur Anmeldung umleitet, dass openccu-lites
Backup (GET /api/system/v1/backup) mui-lite.json, mui-tiles.json und die Sprachprofile enthält, und dass das Journal
des Add-ons keine Schreibfehler (EACCES, EROFS, permission denied) und keinen Panic enthält. Ein
Wiederherstellen ersetzt /usr/local und startet das System neu; dass es die Dateien zurückbringt, ist
Sache des Systems, dass sie im Backup sind, unsere. Die Dauer jedes Schritts steht in der Zusammenfassung
des Workflows, Serial-Log, Journal, Antworten und die Dateiliste des Backups im Artefakt lite-vm-logs.
Scheitert ein Schritt, schreibt das Skript eine Diagnose ins Log des Jobs: Navigation, Add-on und Dienst
aus occulites Sicht, die Antworten unter /addons/mui/ mit Sitzung und die letzten Zeilen des Journals von
lighttpd, addon-mui, occulited und hmipserver (darin VirtualDevices), damit sich ein Fehler ohne die
VM eingrenzen lässt, etwa ob ein Event hmipserver verlassen hat und bei occulited angekommen ist.
Die VM hat kein Funkmodul: Funkgeräte, Anlernen und Werte über Funk bleiben ein Test auf echter Hardware.
Screenshot-Vergleich¶
bun run test:visual · Baselines erneuern: bun run test:visual:update
Zwölf Ansichten (Räume, Gewerke, Kacheln aller Art, Anmeldung, Meldungen, Menü) in drei Größen (Handy,
Tablet hoch und quer), hell und dunkel, mit fester Uhrzeit und Sprache: 72 Bilder unter
e2e/visual.spec.ts-snapshots. Weil Schriften auf jedem Rechner etwas anders gerendert werden, laufen sie
nur mit VISUAL=1, in der CI (Check Screenshots) im Docker-Image mcr.microsoft.com/playwright, aus dem
auch die Baselines stammen. Nach einer gewollten Änderung der Darstellung erneuert der Workflow Update
screenshots (Actions, manuell, auf dem Branch des Pull Requests) die Baselines im selben Image und committet
sie. Lokal geht das mit Docker:
docker run --rm --ipc=host -v "$PWD":/work -w /work -e VISUAL=1 \
mcr.microsoft.com/playwright:v$(grep -oE '@playwright/test@[0-9.]+' bun.lock | head -1 | cut -d@ -f3)-noble \
sh -c 'npm install --global "bun@$(grep -oE "\"bun@[0-9.]+" package.json | cut -d@ -f2)" && bun --bun playwright test visual -u'
Das Image bringt kein Bun mit; wie in der CI kommt es über npm dazu.
Damit jeder Lauf dasselbe Bild liefert, wartet der Test, bis die App keine Anfragen mehr stellt und die Seite
ihre Höhe behält, und nimmt die ganze Seite in einem passend hohen Fenster auf statt mit fullPage. Nur Alle
Geräte lässt 500 abweichende Pixel zu: Das Leuchten der vielen aktiven Kacheln kommt bei jedem Lauf etwas
anders heraus.
Die Bilder der Dokumentation (docs/screenshot-*.png) nimmt bun run docs:screenshots neu auf: die
Kacheln aus dem Mock (e2e/docs-screenshots.spec.ts), die Einrichten-Seiten aus der Fake-CCU
(e2e-stack/docs-screenshots.spec.ts). Derselbe Workflow kann auch sie erneuern.
Die bewegten Bilder der Kacheln in Geräteunterstützung (docs/kacheln/*.webp)
nimmt bun run docs:tiles auf (e2e/docs-tiles.spec.ts, braucht ffmpeg mit libwebp): Jede Kachel des
Mocks spielt eine kurze Szene, in der der Mock Meldungen der CCU schickt (ein Fenster kippt und öffnet, der
Rauchmelder schlägt an). Chromiums Screencast liefert jedes gemalte Bild mit seiner Zeit, ffmpeg macht daraus
eine animierte WebP mit 15 Bildern pro Sekunde. Eine Animation kommt nie zweimal gleich heraus, deshalb hat
der Workflow dafür eine eigene Auswahl tiles.
CI¶
| Workflow | Auslöser | Schritte |
|---|---|---|
build.yml |
Push und Pull Request auf main |
Protokolltypen aktuell (generate:protocol + git diff --exit-code), Unit-Tests, Build mit Typprüfung (vite build && tsc), Go-Build für ARM und x86 und für openccu-lite (aarch64, x86_64), die tar.gz-Archive mit .sha256 als Artefakt addon |
go-unit-tests.yml |
Push und Pull Request auf main |
go vet, gofmt, staticcheck und go test ./... mit Coverage-Bericht als Artefakt, dasselbe mit -tags lite für openccu-lite |
playwright-e2e.yml |
Push und Pull Request auf main |
Im Docker-Image mcr.microsoft.com/playwright (Version aus der bun.lock, kein Browser-Download, Bun über npm install --global in der Version aus packageManager, geprüft mit scripts/test/ci-bun-version.sh): E2E mit Mock inkl. Anmeldung (4 Worker, mit Frontend-Coverage), Screenshot-Vergleich und E2E gegen den Stack auf drei Runnern (--shard), Berichte als Artefakte |
lite-vm.yml |
Pull Request, der den Lite-Teil ändert; montags gegen das neueste openccu-lite; von Hand (mit wählbarem openccu-lite-Release); vor jeder Release gegen das in release.yml festgelegte openccu-lite (zurzeit 2.0.0-beta.4; ein neueres schlägt Renovate als Pull Request vor, .github/renovate.json5), damit ein neues openccu-lite keine Release aufhält |
Paket bauen, openccu-lite-Image laden (zwischengespeichert je Release), in QEMU mit KVM booten, installieren, scripts/lite-vm-test.sh; Dauer je Schritt in der Zusammenfassung, Logs als Artefakt |
release.yml |
Tag vX.Y.Z |
Die vier Workflows oben, dann die Release mit den Archiven und erzeugten Notizen; Go- und Playwright-Tests entfallen, wenn main sie für diesen Code schon bestanden hat |
bump.yml |
von Hand | Version erhöhen, Tag vX.Y.Z anlegen und release.yml darauf starten |
Ein Pull Request wird erst gemergt, wenn alle Prüfungen grün sind.
Selbst laufen lassen¶
bun run test # Vitest
bun run typecheck # TypeScript
bun run test:go # Go
cd go-server && go test -tags lite ./... # Go für openccu-lite
bun run test:e2e # Playwright mit Mock (startet Vite selbst)
bun run test:stack # Playwright gegen Go-Server + Fake-CCU
bun run test:visual # Screenshot-Vergleich
scripts/lite-vm-test.sh <openccu-lite-x86_64-ova-*.zip> mui-*-x86_64-lite.tar.gz # auf einer openccu-lite-VM
Playwright braucht einmal bun run test:e2e:install für Chromium.
Alle Playwright-Läufe starten den Testrunner unter Bun (bun --bun playwright test, so auch in den Skripten
und der CI), Node.js ist dafür nicht nötig. Unter Bun lässt Playwright seinen eigenen Loader weg und lädt
Testdateien eines CommonJS-Pakets so, dass Bun sie als JavaScript liest: Typ-Syntax wie import type oder
as bricht dann das Laden ab. Deshalb erklären e2e/package.json, e2e-stack/package.json und
e2e-update/package.json die Tests zu ES-Modulen, die Bun selbst übersetzt. Für das ganze Repository geht
das nicht: Vite 8 behandelt in einem "type": "module"-Paket den Default-Import von CommonJS-Paketen anders,
useWebSocket aus react-use-websocket wäre dann keine Funktion mehr.