Testen Sie den Upload-Vertrag, keinen Dateipfad.

Eine Dateiauswahl wird geöffnet, der Test wählt eine Datei aus und die Suite erklärt den Upload für abgeschlossen. Die Anwendung hat nur die Eingabeauswahl erhalten. Möglicherweise wird das Format dennoch abgelehnt, die Validierung schlägt fehl oder die Verarbeitung wird nie abgeschlossen. Ein grüner Auswahlschritt ist ein engeres Ergebnis als ein verwendbares hochgeladenes Dokument.

Diese Anleitung verwendet Playwrights Eingabedokumentation, um eine kleine lokale Textdatei-Fixture zu erstellen. Die Datei enthält erfundene Inhalte. Es handelt sich nicht um einen Kundenanhang, ein Ausweisdokument oder ein Produktbeispiel. Wir trennen den Browser-Eingabevertrag von der Verarbeitung, die die Anwendung anschließend durchführt.

Geben Sie dem Gerät eine lesbare Identität

Ein Testgerät sollte seinen Namen, MIME-Typ und Inhalt angeben. Ein kleines Textbeispiel: Eine In-Memory-Nutzlast ist einfacher zu überprüfen als eine ungeklärte Binärdatei in einem Repository. Verwenden Sie realistische, gültige Eingaben für Ihr Produkt, vermeiden Sie jedoch private Quelldokumente, wenn eine kontrollierte Probe die Frage beantworten wird.

await page.getByLabel('Demo attachment').setInputFiles({
  name: 'demo-note.txt',
  mimeType: 'text/plain',
  buffer: Buffer.from('Invented demo note\n', 'utf8')
});
await expect(page.getByRole('status')).toHaveText('Selected: demo-note.txt');

Das Snippet geht von einer zugänglichen Dateieingabe und einem lokalen UI-Verhalten aus, das den ausgewählten Dateinamen meldet. Die Behauptung stellt fest, dass dieses Verhalten keine erfolgreiche Serverspeicherung darstellt. Behalten Sie diese Grenze im Testtitel und in der erläuternden Abbildung bei.

Playwright dokumentiert Pfade, mehrere Dateien, Nutzlastobjekte und löscht die Auswahl über setInputFiles. Wählen Sie die kleinste Eingabeform aus, die der Groß-/Kleinschreibung entspricht. Für einen Test mit mehreren Dateien sind Anforderungen an Reihenfolge, Grenzwerte und einzelne Fehler erforderlich. es ist nicht einfach derselbe Happy-Path-Check, der mit mehr Namen wiederholt wird.

Verwenden Sie ein Auswahlereignis nur, wenn es die erforderliche Grenze darstellt

Einige Schnittstellen erstellen die Eingabe dynamisch nach einem Tastenklick. Der Eingabeleitfaden beschreibt das Warten auf das Filechooser-Ereignis vor der Aktion und den anschließenden Aufruf von setFiles für den zurückgegebenen Chooser. Stellen Sie die Ereigniswartezeit an die erste Stelle, damit weiterhin eine Schnellauswahl mit dem initiierenden Steuerelement verbunden ist.

const pendingChooser = page.waitForEvent('filechooser');
await page.getByRole('button', { name: 'Choose demo file' }).click();
const chooser = await pendingChooser;
await chooser.setFiles({
  name: 'demo-note.txt',
  mimeType: 'text/plain',
  buffer: Buffer.from('Invented demo note\n', 'utf8')
});

Hierbei handelt es sich um alternative Auswahlansätze für verschiedene Schnittstellen, nicht um zwei erforderliche Schritte in einem Upload. Automatisieren Sie einen nativen Betriebssystemdialog nicht durch erratene Bildschirmkoordinaten, wenn die dokumentierte Eingabe oder Auswahlgrenze die Aktion direkt ausdrücken kann.

Auswahl, Annahme und Bearbeitung sind getrennte Zustände

Nach der Auswahl kann die Anwendung die Datei prüfen, sie an einen Server senden und einen Hintergrundprozessor ausführen. Schreiben Sie den erwarteten Zustand für jede relevante Ebene. Die benutzerseitige Akzeptanznachricht sollte das bedeuten, was sie sagt. Wenn die Verarbeitung noch aussteht, sollte der Test nicht das gesamte Feature als abgeschlossen kennzeichnen.

Für einen tatsächlichen Upload-Vorgang verwenden Sie einen genehmigten Staging-Speicher und überprüfen Sie den endgültigen kontrollierten Datensatz anhand der unterstützten Nachweise des Produkts. Überprüfen Sie, ob das richtige Dokument verfügbar ist und nicht nur, dass ein Spinner verschwunden ist. Laden Sie erfundene Tests nicht nur deshalb in den Ordner eines Live-Kunden hoch, weil die Benutzeroberfläche dies erleichtert.

Ein Dateiname und ein MIME-Typ sind Eingaben und kein unabhängiger Beweis des Dateiinhalts. Eine Textnutzlast namens image.png ist kein gültiges Bild. Wählen Sie absichtlich ungültige Proben, wenn Sie die Ablehnung testen, und gültige Proben, wenn Sie die Akzeptanz testen. Erklären Sie, welchen Vertrag jedes Exemplar ausüben soll.

Halten Sie ungültige Fälle klein und nützlich

Das Produkt lehnt möglicherweise ein nicht unterstütztes Format, eine übergroße Eingabe, eine leere Datei oder ein Duplikat ab. Legen Sie vom Anwendungsteam die erwarteten Richtlinien fest, bevor Sie diese Aussagen verfassen. Erfinden Sie keine maximale Größe und gehen Sie nicht davon aus, dass ein Browser-Akzeptanzattribut die gesamte Sicherheitsregel darstellt.

Überprüfen Sie die Erklärung und sichern Sie die nächste Aktion für eine abgelehnte Datei. Ein Benutzer sollte in der Lage sein, eine andere Datei auszuwählen oder die Auswahl zu entfernen, wenn dies das beabsichtigte Design ist. Auch die Testbereinigung ist wichtig: Ein akzeptierter Staging-Upload kann auch nach dem Schließen des Browsers bestehen bleiben, also veranlassen Sie die Datensatzentfernung über einen genehmigten Weg.

Behalten Sie Vorrichtungen und daraus resultierende Fehlerartefakte unter einer Datenschutzprüfung. Kleine erfundene Eingaben sind einfacher zu prüfen und sicherer zu verteilen als erfasste echte Dokumente. Screenshots und Spuren können ausgewählte Dateinamen offenbaren, auch wenn die Dateibytes nicht angehängt sind.

AnyTest beschreibt Agenten, die eine Web-App erkunden und End-to-End-Tests zur menschlichen Überprüfung erstellen. Nutzen Sie diese Grenzen, um jede vorgeschlagene Dateireise zu überprüfen: ausgewählt, akzeptiert, verarbeitet und verfügbar. In diesem Handbuch wird keine bestimmte AnyTest-Upload-Schnittstelle oder Validierungsintegration festgelegt. Der Vorteil ist ein klarer Artefaktvertrag, der verhindert, dass eine erfolgreiche Eingabeaktion zu einer falschen Zusage über Serverergebnisse wird.