Wie man Shared‑Resource‑Tests sicher hält und gleichzeitig Playwrights Parallelität ausnutzt
1. Warum "parallel" nicht immer "sicher" ist
Playwrights Standard-Testrunner führt Dateien in parallelen Workers aus und führt innerhalb jeder Datei Tests gleichzeitig aus, wenn fullyParallel aktiviert ist. Dies führt zu dramatischen Geschwindigkeitssteigerungen bei CI, setzt aber auch voraus, dass jeder Test isoliert ist – d. h. er hängt nicht von einem veränderlichen externen Zustand ab, den ein anderer Test gleichzeitig berühren könnte.
Typische nicht-isolierte Szenarien sind:
| Gemeinsame Ressource | Typischer Konflikt |
|---|---|
| Ein einzelnes Testkonto auf einem externen SaaS-Dienst | Gleichzeitige Passwortänderungen, Datenlöschungen |
| Eine kursbegrenzte Sandbox-Umgebung | Überschreitung der Anfragequoten |
| Globale Konfigurationsdateien, die von Tests geschrieben wurden | Überschreibt diese korrupten späteren Läufe |
| Testdaten, die in einer gemeinsamen Datenbank liegen | Gleichzeitige Einfügungen/Updates verursachen fehlerhafte Lesevorgänge |
Wenn solche Ressourcen ohne Koordination genutzt werden, werden Tests unzuverlässig und CI-Pipelines verlieren ihre Zuverlässigkeit. Historisch bestand der Workaround darin, die gesamte Suite (oder eine gesamte Datei) als seriell zu markieren, was garantiert, dass keine zwei Tests gleichzeitig laufen. Der Nachteil ist, dass die gesamte Suite an Parallelität verliert und die Ausführungszeit erhöht.
Playwright 1.63 führt benannte Testsperren ein, um diese Lücke zu schließen. Sperren ermöglichen es, eine benannte Ressource zu deklarieren, die exklusiv sein muss, während alle anderen Tests parallel laufen. Die Funktion funktioniert über Dateien, Worker-Prozesse und Projekte – genau die Grenzen, an denen zuvor Nebenläufigkeit Probleme verursachte.
> Offizielles Verhalten – Playwright erwirbt alle Sperren eines Tests, bevor der Test beginnt, und gibt sie nach Abschluss frei. Im Standard- und Serienmodus wird eine für einen Test deklarierte Sperre für die gesamte Datei gehalten; bei vollständig paralleler Ausführung gilt sie nur für den einzelnen Test. (Playwright-Dokumentation zu Test Locks)
Der Rest dieses Artikels erklärt, wie man Sperren richtig verwendet, wie sie mit Arbeitern und Projekten interagieren und wie man eine pragmatische QA-Strategie entwirft, die Blockaden vermeidet und dabei den Großteil der parallelen Beschleunigung bewahrt.
2. Drei Baseline‑Ansätze
| Herangehensweise | Parallelität | Isolationsgarantie | Typischer Anwendungsfall |
|---|---|---|---|
| Isolierte Tests (kein gemeinsamer Zustand) | Vollständige Parallele über Arbeiter, Dateien und Projekte hinweg | Jeder Test läuft unabhängig voneinander; keine Koordination erforderlich | Reine Unit-Style-UI-Tests |
Vollständig serielle Suite (test.describe.configure({ mode: 'serial' })) | Keine Parallelität innerhalb der Datei; Dateien laufen weiterhin in parallelen Arbeitern | Garantiert, dass beliebige zwei Tests in der Datei niemals überlappen | Legacy-Suiten, die auf einem globalen Browser oder einer gemeinsamen Datenbank basieren |
| Schmal abgeschirmte Schlösser (neu in 1.63) | Parallelität wird für alle Tests beibehalten, die nicht einen Lock-Namen teilen | Nur Tests, die denselben Schlossnamen deklarieren, werden serialisiert; andere laufen gleichzeitig | Tests, die ein einzelnes Testkonto, einen rate-limitierten Sandbox oder eine globale Konfigurationsdatei benötigen |
Der Lock-Ansatz ist für die meisten Teams der Sweet Spot: Man behält die schnelle Standardparallelität bei und serialisiert nur die minimale Anzahl von Tests, die wirklich widersprechen.
3. Festlegung von Sperren – Syntax und Umfang
3.1 Auf Testebene
import { test, expect } from '@playwright/test';
test('create user in shared sandbox', { lock: 'sandbox-A' }, async ({ page }) => {
// The lock name "sandbox‑A" is acquired before the test starts.
// No other test that also asks for "sandbox‑A" will run concurrently.
await page.goto('https://example.com/signup');
// …
});Der Sperrname wird im Test-Optionsobjekt deklariert:
test('update shared account', { lock: 'shared-account' }, async ({ page }) => {
// Der Test startet erst, wenn die benannte Sperre verfügbar ist.
// …
});Wenn fullyParallel aus ist (der Standard), wird die Sperre für die gesamte Datei gehalten, weil der Testläufer die Datei als eine einzelne Einheit behandelt. Wenn fullyParallel eingeschaltet ist, bleibt die Sperre nur für die Dauer des einzelnen Tests gehalten.
3.2 Auf test.describe Ebene
Wenn eine ganze Gruppe von Tests dieselbe exklusive Ressource benötigt, kannst du die Sperre einmal deklarieren:
test.describe('Operations on shared sandbox A', () => {
test.describe.configure({ lock: 'sandbox‑A' });
test('reset sandbox', async ({ page }) => {
// lock already acquired
// …
});
test('run migration script', async ({ page }) => {
// same lock, same exclusivity guarantee
// …
});
});Alle Tests im describe übernehmen den Namen des Schlosses, was die Wartung vereinfacht.
3.3 Mehrfachsperren
Ein Test kann mehr als eine Sperre anfordern, indem er ein Array durchführt:
test('reset the database', { lock: ['sandbox-A', 'shared-account'] }, async () => {
// …
});Playwright erwirbt alle angeforderten Sperren vor dem Teststart und gibt sie nach Abschluss frei. Die Dokumentation definiert weder Reihenfolge noch Fairness beim Erwerb; Tests und QA-Richtlinien dürfen sich daher nicht darauf verlassen.
4. Benennungskonventionen – den Sperrraum handhabbar halten
Da Schlossnamen während des gesamten Testlaufs global sind, verhindert ein diszipliniertes Benennungsschema versehentliche Kollisionen:
| Empfehlung | Beispiel |
|---|---|
| Präfix mit dem Ressourcentyp | account‑admin, sandbox‑us‑east |
| Verwenden Sie Kebab-Case (Der Playwright behandelt Namen als Strings) | sandbox‑a |
| Halten Sie Namen kurz, aber beschreibend | rate‑limit‑api |
| Dokumentiere die Sperrkarte in einer gemeinsamen README | (siehe Migrationsplan) |
Eine klare Karte erleichtert es neuen Mitwirkenden zu verstehen, welche Tests nicht zusammenlaufen dürfen.
5. Interaktion mit Workern, Projekten und CI‑Sharding
5.1 Worker
Playwright führt Tests in einer konfigurierbaren Anzahl von Worker-Prozessen aus. Sperren gelten über Worker hinweg: Hält Worker 1 die Sperre sandbox‑A, wartet Worker 2, bevor ein weiterer Test mit derselben Sperre startet. Diese Garantie ermöglicht sichere Parallelität.
5.2 Projekte
Projekte sind separate Konfigurationen (z. B. Chrome vs. Firefox). Sperren sind auch global über Projekte hinweg. Ein Test im chromium Projekt, der shared‑account sperrt, blockiert den gleichnamigen Test im firefox Projekt, bis der Sperre aufgehoben wird. Dies verhindert, dass zwei Browser gleichzeitig dasselbe externe Konto mutieren.
5.3 CI‑Sharding
CI-Systeme teilen die Testsuite oft in Shards auf, die auf verschiedenen Agenten laufen. Playwrights Lock-Implementierung ist prozesslokal; sie koordiniert nicht über separate CI-Maschinen. Daher garantiert eine Sperre nur Exklusivität in einem einzigen CI-Job. Wenn eine gemeinsame Ressource wirklich nicht gleichzeitig über Agenten hinweg zugänglich ist, müssen Sie entweder:
- Verteilt separate Ressourcen pro Shard (z. B. separate Testkonten), oder
- Verwenden Sie einen benutzerdefinierten externen Schlossdienst (außerhalb des Umfangs der eingebauten Funktion von Playwright).
Der Artikel behauptet nicht verteiltes Sperren über CI-Maschinen hinweg, da die offizielle Dokumentation dies nicht garantiert.
6. Praktische Aspekte
6.1 Timeouts
Playwright gibt keinen lock-spezifischen Timeout frei. Wenn ein Test seine Sperre nicht erhalten kann, weil ein anderer Test feststeckt, bleibt der Wartetest einfach in der Warteschlange, bis die Sperre freigegeben wird. In der Praxis kann dies dazu führen, dass die gesamte Suite die CI-Timeout überschreitet. Minderungsstrategien:
- Halte den kritischen Abschnitt (den Code, der das Schloss benötigt) so kurz wie möglich.
- Füge dem Test selbst explizite
testInfo.setTimeout()hinzu, sodass ein hängendes Lock dazu führt, dass der Test scheitert, anstatt den gesamten Durchlauf abzuhalten.
6.2 Fehlerwiederherstellung
Playwright gibt die Sperren eines Tests nach dessen Abschluss frei und beendet einen Worker nach einem Testfehler. Ein externer Zustand kann dennoch beschädigt bleiben (zum Beispiel ein teilweise aktualisiertes Konto), sodass nachfolgende Tests weiterhin fehlschlagen können. Empfohlene Vorgehensweise:
- Verwenden Sie
test.afterEachodertest.afterAllHooks, um die gemeinsame Ressource zu bereinigen selbst wenn der Test fehlschlägt. - Betrachten Sie einen "Reset"-Test, der zu Beginn jedes CI-Jobs durchgeführt wird, um die Ressource wieder auf eine bekannte Basis zurückzuführen.
6.3 Beobachtbarkeit
Die offizielle Dokumentation beschreibt das Sperrverhalten, stellt aber keine Telemetrie zum Erwerb der Sperren bereit. Zeitdaten sollten daher als team-eigene Instrumentierung behandelt werden:
- Testkennung und deklarierte gemeinsam genutzte Ressource protokollieren;
- Start- und Endzeitpunkte in CI-Logs oder einem eigenen Reporter erfassen;
- Tests mit demselben Sperrnamen mit unabhängigen Tests vergleichen.
Diese Daten machen unerwartete Konkurrenz sichtbar, ohne undokumentierte Runner-Interna zu behaupten.
6.4 Vermeidung von Deadlocks
Playwright wartet, bis alle angeforderten Sperren verfügbar sind, bevor ein Test startet. Die folgende Teamrichtlinie soll daher Konkurrenz begrenzen und die Nutzung prüfbar halten:
- Regel 1 – Möglichst nicht mehr als zwei Sperren pro Test; Ausnahmen müssen dokumentiert und geprüft werden.
- Regel 2 – Häufig gemeinsam benötigte Sperren als geprüfte Gruppe dokumentieren.
- Regel 3 – Kanonische Ressourcennamen wiederverwenden; keine Aliase für dieselbe Ressource anlegen.
So bleibt das Sperrregister klein und nachvollziehbar.
7. Architektur‑ und Datenfluss‑Ansicht
Testdateien → benannte Sperroptionen → Runner-Koordination → Worker-Prozess → Testergebnis
- Eingaben – Testdateien,
{ lock: … }-Optionen und Playwright-Konfiguration (fullyParallel,projects). - Ausgaben – Testergebnisse (bestanden/nicht bestanden), optionale Lock-Acquisition-Logs und etwaige Nebenwirkungen auf die geteilte Ressource.
Das Diagramm zeigt die dokumentierte Funktionsweise konzeptionell: Playwright koordiniert benannte Sperren über Worker-Prozesse und Projekte, bevor ein Test starten darf.
8. Testdesign-Checkliste
| Kategorie | Was zu überprüfen ist |
|---|---|
| Positiv | Ein Test, der Lock sandbox‑A deklariert, läuft erfolgreich, wenn kein anderer Test diese Sperre hält. |
| Negativ | Zwei Tests, die beide fordern, überschneiden sich sandbox‑A nie; der zweite Test beginnt erst nach dem ersten Test. |
| Gleichzeitig | Tests mit verschiedenen Sperrnamen (sandbox‑A vs. sandbox‑B) laufen parallel, selbst wenn sie im selben Worker-Pool ausgeführt werden. |
| Timeout-Handling | Ein absichtlich langsamer Test verwendet einen expliziten Test-Timeout; Bereinigung und Wiederherstellung des externen Zustands werden separat geprüft. |
| CI-Splitterung | Wenn die Suite in zwei Shards aufgeteilt wird, verwendet jeder Shard einen eigenen Locknamen (oder externe Isolation), um Konflikte zwischen Agenten zu vermeiden. |
Automatisierte Verifizierung kann zu einer "Lock Sanity"-Testsuite hinzugefügt werden, die in einem dedizierten CI-Job läuft.
9. Migrationsplan – von vollständig serieller zu lock-basierter Parallelität
- Gemeinsame Ressourcen identifizieren – Listen Sie externe Konten, Sandboxen, Konfigurationsdateien und Datenbanken auf, die durch Tests mutiert werden.
- Sperrnamen hinzufügen – Ergänze
{ lock: 'resource-name' }als Test-Optionsargument für jeden Test, der auf eine gemeinsam genutzte Ressource zugreift. - Führe eine Baseline durch – Führe die Suite mit
fullyParallel: trueaus und bestätige, dass die Lock-Sanity-Tests (Abschnitt 8) bestehen. - Gradweise erweitern – Wenn ein neuer Test dieselbe Ressource benötigt, fügen Sie denselben Schlossnamen hinzu.
- Messen – Vergleichen Sie die gesamte Suite-Dauer vor und nach der Einführung der Sperre. Unabhängige Tests sollten weiterhin parallel durchgeführt werden; die Verringerung der Wanduhrzeit ist der primäre KPI.
- Menschlich eigenes Freigabe-Tor – Bevor ein PR zusammengeführt wird, das ein neues Schloss einführt, muss ein Prüfer überprüfen, ob der Schlossname dokumentiert ist und kein bestehender Test ihn bereits unbeabsichtigt verwendet. Dieses Tor verhindert eine versehentliche Verbreitung von Schlossen.
Die Migration kann schrittweise durchgeführt werden; Sie müssen nicht die gesamte Suite in den seriellen Modus umstellen.
10. Messbare Hinweise darauf, dass nicht verwandte Tests parallel bleiben
Verwende explizite Start- und Endzeitpunkte aus CI-Logs oder einem benutzerdefinierten Reporter, um Parallelität nachzuweisen. Nach der Migration sollten die Daten zeigen:
- Überlappende Balken für Tests ohne ein gemeinsames Schloss.
- Lücken nur, wenn zwei Tests mit demselben Schlossnamen serialisiert sind.
Berechne aus diesen Zeitpunkten einen beobachteten Parallelitätsfaktor:
Parallelitätsfaktor = Summe der einzelnen Testdauern / Gesamtdauer des TestlaufsEin Verhältnis nahe der Anzahl der Arbeiter zeigt, dass die Schlösser die Suite nicht drosselen.
11. Wo Automatisierung hilft
| Gebiet | Automatisierungsmöglichkeit |
|---|---|
| Validierung der Sperrkarte | Eine Lint-Regel, die Testdateien auf lock: Nutzung scannt und doppelte oder fehlende Dokumentation markiert. |
| Deadlock-Erkennung | Ein Skript, das einen Sperrabhängigkeitsgraphen aus der Testsuite erstellt und warnt, ob ein Knoten Grad > 2 (pro Richtlinie) hat. |
| Leistungsregression | CI-Job, der die Laufzeit der Suite aufzeichnet und scheitert, wenn das Parallelitätsverhältnis unter eine Schwelle fällt. |
| Ressourcen-Gesundheitsprüfungen | Pretest-Haken, der überprüft, ob die externe Sandbox erreichbar ist; wenn nicht, bricht die Suite vorzeitig ab. |
| Tor-Durchsetzung freigeben | Pull-Request-Check, der sicherstellt, dass jeder neue Schlossname zur gemeinsamen Lock-Registry-Datei hinzugefügt wird. |
Diese automatisierten Wachen sorgen dafür, dass die Schlossstrategie mit wachsender Testbasis aufrechterhalten bleibt.
12. Empfohlene QA-Strategie (unsere Sichtweise)
- Isolation bevorzugen – Schreibe Tests, die keine Sperre benötigen, wann immer möglich.
- Führe Schlösser nur für wirklich gemeinsame Ressourcen ein – Nutze die oben genannten Namenskonventionen und Richtlinienregeln.
- Kritische Abschnitte winzig – Verschieben Sie alle nicht essenziellen Arbeiten außerhalb des gesperrten Bereichs (z. B. kann die Seitennavigation vor dem Erwerb der Sperre erfolgen, wenn sie den gemeinsamen Zustand nicht beeinflusst).
- Sperrkonkurrenz überwachen – Prüfe die aufgezeichneten Zeitdaten oder ein eigenes Sperrprotokoll, damit die Konkurrenz gering bleibt.
- Dokumentieren und prüfen – Schließen Sie Namen als gemeinsamen Vertrag an; jede Änderung muss durch das von Menschen betriebene Freigabe-Portal erfolgen.
Mit diesem Ansatz behält man den Großteil der parallelen Geschwindigkeit von Playwright und eliminiert die Unsicherheit, die durch gleichzeitigen Zugriff auf externe Ressourcen entsteht.
13. Prüfungsfragen
- Was ist der Unterschied zwischen dem Verhalten eines Schlosses im Standardmodus und
fullyParallelModus? - Wie setzt Playwright die Exklusivität von Locks zwischen Arbeitern und Projekten durch?
- Listen Sie zwei praktische Richtlinien auf, die das Risiko von Deadlocks bei Verwendung mehrerer Sperren verringern.
- Warum muss ein Team Schlossnamen als gemeinsamen Vertrag behandeln und eine Release-Gate-Überprüfung durchsetzen?
- Welchen Teil der Testsuite solltest du nach der Einführung der Testsperren noch vollständig seriell behalten, falls überhaupt?
14. Fazit
Die benannten Testschlösser von Playwright 1.63 geben QA-Teams ein präzises Werkzeug, um nur die Tests zu serialisieren, die tatsächlich exklusiven Zugriff auf eine externe Ressource benötigen. Indem Sie den Umfang der Sperren verstehen, sie konsistent benennen und eine Lightweight-Richtlinie zur Vermeidung von Deadlocks anwenden, können Sie den Großteil Ihrer Suite parallel laufen lassen und gleichzeitig fehlerhafte Fehler durch Shared-State-Konflikte vermeiden. Kombinieren Sie den eingebauten Sperrmechanismus mit automatisiertem Linting, Leistungsüberwachung und einem menscheneigenen Release-Gate, und Sie haben eine robuste, skalierbare Testpipeline, die sowohl Geschwindigkeit als auch Zuverlässigkeit respektiert.
Kommentar hinterlassen
Teilen Sie Ihre Gedanken zum Artikel. Kein Konto erforderlich.
Kommentare
Kommentare werden geladen…